Create Business Entity
curl --request POST \
--url https://api.meow.com/v1/entities \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}
'import requests
url = "https://api.meow.com/v1/entities"
payload = {
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": True,
"transacts_in_digital_currency": True,
"develops_governs_supports_blockchain_protocol": True,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
business_phone: '+14155550123',
business_taxid: '12-3456789',
business_website: 'https://catnipcoffee.com',
business_description: 'Specialty coffee roaster and cafe',
business_asset_source_description: 'Operating revenue',
account_purpose_description: '<string>',
provides_blockchain_or_digital_currency_services: true,
transacts_in_digital_currency: true,
develops_governs_supports_blockchain_protocol: true,
business_name: 'Catnip Coffee Co',
business_date_of_incorporation: '2023-12-25',
incorporation_state: 'DE',
business_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
physical_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
reference_id: 'catnip-coffee-4471'
})
};
fetch('https://api.meow.com/v1/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meow.com/v1/entities"
payload := strings.NewReader("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meow.com/v1/entities")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meow.com/v1/entities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meow.com/v1/entities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'business_phone' => '+14155550123',
'business_taxid' => '12-3456789',
'business_website' => 'https://catnipcoffee.com',
'business_description' => 'Specialty coffee roaster and cafe',
'business_asset_source_description' => 'Operating revenue',
'account_purpose_description' => '<string>',
'provides_blockchain_or_digital_currency_services' => true,
'transacts_in_digital_currency' => true,
'develops_governs_supports_blockchain_protocol' => true,
'business_name' => 'Catnip Coffee Co',
'business_date_of_incorporation' => '2023-12-25',
'incorporation_state' => 'DE',
'business_address' => [
'address' => '9 Whisker Way',
'city' => 'San Francisco',
'zip' => '94105',
'address_2' => 'Suite 9',
'state' => 'CA'
],
'physical_address' => [
'address' => '9 Whisker Way',
'city' => 'San Francisco',
'zip' => '94105',
'address_2' => 'Suite 9',
'state' => 'CA'
],
'reference_id' => 'catnip-coffee-4471'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const url = 'https://api.meow.com/v1/entities';
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
business_phone: '+14155550123',
business_taxid: '12-3456789',
business_website: 'https://catnipcoffee.com',
business_description: 'Specialty coffee roaster and cafe',
business_asset_source_description: 'Operating revenue',
account_purpose_description: '<string>',
provides_blockchain_or_digital_currency_services: true,
transacts_in_digital_currency: true,
develops_governs_supports_blockchain_protocol: true,
business_name: 'Catnip Coffee Co',
business_date_of_incorporation: '2023-12-25',
incorporation_state: 'DE',
business_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
physical_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
reference_id: 'catnip-coffee-4471'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));using RestSharp;
var options = new RestClientOptions("https://api.meow.com/v1/entities");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
val request = Request.Builder()
.url("https://api.meow.com/v1/entities")
.post(body)
.addHeader("x-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()import Foundation
let parameters = [
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": [
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
],
"physical_address": [
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
],
"reference_id": "catnip-coffee-4471"
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.meow.com/v1/entities")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))falsefalse$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.meow.com/v1/entities' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"business_name": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": 123,
"message": "<string>",
"debug_message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}Onboarding
Create a business entity
Creates a new business entity owned by your API key’s user. Send an empty body to create a bare not-started entity, or seed any KYB business details up front: legal name, incorporation, the registered legal and (optional) physical address, and the business profile fields (phone, tax ID, website, description, industry, account purpose, and digital-currency questions). The creating user is granted admin on the new entity, so the same API key can immediately act on it by passing the returned entity ID in the x-entity-id header. Anything you omit can be added later with Update Business Details. The entity still completes KYB (beneficial owners and any remaining details) before it can be approved or open bank accounts.
POST
/
entities
Create Business Entity
curl --request POST \
--url https://api.meow.com/v1/entities \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}
'import requests
url = "https://api.meow.com/v1/entities"
payload = {
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": True,
"transacts_in_digital_currency": True,
"develops_governs_supports_blockchain_protocol": True,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
business_phone: '+14155550123',
business_taxid: '12-3456789',
business_website: 'https://catnipcoffee.com',
business_description: 'Specialty coffee roaster and cafe',
business_asset_source_description: 'Operating revenue',
account_purpose_description: '<string>',
provides_blockchain_or_digital_currency_services: true,
transacts_in_digital_currency: true,
develops_governs_supports_blockchain_protocol: true,
business_name: 'Catnip Coffee Co',
business_date_of_incorporation: '2023-12-25',
incorporation_state: 'DE',
business_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
physical_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
reference_id: 'catnip-coffee-4471'
})
};
fetch('https://api.meow.com/v1/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meow.com/v1/entities"
payload := strings.NewReader("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meow.com/v1/entities")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meow.com/v1/entities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meow.com/v1/entities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'business_phone' => '+14155550123',
'business_taxid' => '12-3456789',
'business_website' => 'https://catnipcoffee.com',
'business_description' => 'Specialty coffee roaster and cafe',
'business_asset_source_description' => 'Operating revenue',
'account_purpose_description' => '<string>',
'provides_blockchain_or_digital_currency_services' => true,
'transacts_in_digital_currency' => true,
'develops_governs_supports_blockchain_protocol' => true,
'business_name' => 'Catnip Coffee Co',
'business_date_of_incorporation' => '2023-12-25',
'incorporation_state' => 'DE',
'business_address' => [
'address' => '9 Whisker Way',
'city' => 'San Francisco',
'zip' => '94105',
'address_2' => 'Suite 9',
'state' => 'CA'
],
'physical_address' => [
'address' => '9 Whisker Way',
'city' => 'San Francisco',
'zip' => '94105',
'address_2' => 'Suite 9',
'state' => 'CA'
],
'reference_id' => 'catnip-coffee-4471'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const url = 'https://api.meow.com/v1/entities';
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
business_phone: '+14155550123',
business_taxid: '12-3456789',
business_website: 'https://catnipcoffee.com',
business_description: 'Specialty coffee roaster and cafe',
business_asset_source_description: 'Operating revenue',
account_purpose_description: '<string>',
provides_blockchain_or_digital_currency_services: true,
transacts_in_digital_currency: true,
develops_governs_supports_blockchain_protocol: true,
business_name: 'Catnip Coffee Co',
business_date_of_incorporation: '2023-12-25',
incorporation_state: 'DE',
business_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
physical_address: {
address: '9 Whisker Way',
city: 'San Francisco',
zip: '94105',
address_2: 'Suite 9',
state: 'CA'
},
reference_id: 'catnip-coffee-4471'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));using RestSharp;
var options = new RestClientOptions("https://api.meow.com/v1/entities");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
request.AddJsonBody("{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"business_phone\": \"+14155550123\",\n \"business_taxid\": \"12-3456789\",\n \"business_website\": \"https://catnipcoffee.com\",\n \"business_description\": \"Specialty coffee roaster and cafe\",\n \"business_asset_source_description\": \"Operating revenue\",\n \"account_purpose_description\": \"<string>\",\n \"provides_blockchain_or_digital_currency_services\": true,\n \"transacts_in_digital_currency\": true,\n \"develops_governs_supports_blockchain_protocol\": true,\n \"business_name\": \"Catnip Coffee Co\",\n \"business_date_of_incorporation\": \"2023-12-25\",\n \"incorporation_state\": \"DE\",\n \"business_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"physical_address\": {\n \"address\": \"9 Whisker Way\",\n \"city\": \"San Francisco\",\n \"zip\": \"94105\",\n \"address_2\": \"Suite 9\",\n \"state\": \"CA\"\n },\n \"reference_id\": \"catnip-coffee-4471\"\n}")
val request = Request.Builder()
.url("https://api.meow.com/v1/entities")
.post(body)
.addHeader("x-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()import Foundation
let parameters = [
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": [
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
],
"physical_address": [
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
],
"reference_id": "catnip-coffee-4471"
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.meow.com/v1/entities")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))falsefalse$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.meow.com/v1/entities' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"business_phone": "+14155550123",
"business_taxid": "12-3456789",
"business_website": "https://catnipcoffee.com",
"business_description": "Specialty coffee roaster and cafe",
"business_asset_source_description": "Operating revenue",
"account_purpose_description": "<string>",
"provides_blockchain_or_digital_currency_services": true,
"transacts_in_digital_currency": true,
"develops_governs_supports_blockchain_protocol": true,
"business_name": "Catnip Coffee Co",
"business_date_of_incorporation": "2023-12-25",
"incorporation_state": "DE",
"business_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"physical_address": {
"address": "9 Whisker Way",
"city": "San Francisco",
"zip": "94105",
"address_2": "Suite 9",
"state": "CA"
},
"reference_id": "catnip-coffee-4471"
}'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"business_name": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": 123,
"message": "<string>",
"debug_message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}{
"error_code": "<string>",
"message": "<string>"
}Authorizations
Your Meow API key, sent in the x-api-key header for authentication.
Body
application/json
Business phone number.
Required string length:
10 - 20Example:
"+14155550123"
Business tax ID: the EIN for US businesses, or the local registration/tax number elsewhere (e.g. UEN in Singapore, UTR in the UK).
Maximum string length:
50Example:
"12-3456789"
Public website of the business.
Maximum string length:
400Example:
"https://catnipcoffee.com"
Short description of what the business does.
Maximum string length:
400Example:
"Specialty coffee roaster and cafe"
Description of the source of the business's assets. Required before submitting an application that requests stablecoins.
Maximum string length:
400Example:
"Operating revenue"
The industry the business operates in.
Available options:
accounting_bookkeeping, accounting_bookkeeping_tax_preparation, advertising, art, art_theater, art_painting, art_sculpting, beauty_cosmetic_services, biotech, business_management, cafeterias_grill_buffets_buffets, caterers, cleaning_services, construction, consulting, consulting_strategy, consulting_business, consulting_financial, crypto, crypto_exchange, crypto_investments, crypto_daos, crypto_nfts, crypto_mining, saas, design, design_web, design_digital, design_interior, design_fashion, drinking_places_alcoholic_beverages, ecommerce, ecommerce_amazon, ecommerce_ebay, ecommerce_shopify, education, education_university, education_financial, energy, energy_solar, energy_wind, energy_refining, energy_fuel, entertainment, entertainment_television, entertainment_film, entertainment_music, entertainment_print, financial_services, financial_services_money_services_business, financial_services_payment_processor, financial_services_fintech, financial_services_consumer_commercial_lending, fitness, food, food_restaurant_food_truck, food_manufacturing, food_service_contractors, full_service_restaurants, hardware, health_services, health_services_clinic, health_services_telehealth, health_services_holistic_services, health_services_healthcare_tech, holding, insurance, investment, investment_venture_capital, legal, legal_attorney, legal_paralegal, limited_service_restaurants, marketing, marketplace, merchant_banking, merges_and_acquisitions, mining, mobile_food_services, nonprofit, other, private_equity, professional_services, professional_services_architect, professional_services_attorney, professional_services_doctor, professional_services_engineer, professional_services_paralegal, real_estate, real_estate_short_term_rental, real_estate_development, real_estate_investing, real_estate_property_management, recruiting, research, research_medical, research_scientific, research_market, retail_wholesale, security, security_private, security_infosec, shipping_warehousing, sports_team, support_services, snack_and_nonalcoholic_beverage_bars, software, software_b2b, software_developer_tools, software_enterprise_software, technology, technology_agriculture, technology_artificial_intelligence, technology_augmented_reality, technology_community, technology_consumer, technology_drones, technology_government, technology_it_telecom, technology_robotics, technology_virtual_reality, transportation, transportation_limo_car_service, transportation_ride_share, travel, travel_agency, travel_hotel_reservations, waste_management, cannabis Why the business needs the account.
Available options:
additional_yield, business_operations, other Free-text detail for the account purpose, when relevant.
Maximum string length:
400Whether the business provides blockchain or digital currency services.
Whether the business transacts in digital currency.
Whether the business develops, governs, or supports a blockchain protocol.
Legal business name.
Required string length:
1 - 400Example:
"Catnip Coffee Co"
Date the business was incorporated.
US state of incorporation. Required for businesses incorporated in the US; omit for businesses incorporated elsewhere.
Available options:
AL, AK, AZ, AR, CA, CO, CT, DC, DE, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, PR Example:
"DE"
Legal structure of the business (e.g. llc, corp). Businesses incorporated outside the US use foreign_entity.
Available options:
ccorp, corp, estate, foreign_entity, llc, llp, lp, nonprofit, partnership, scheme, scorp, soleprop, trust Registered legal business address. Must be in a country where Meow supports business onboarding; unsupported countries are rejected with the full supported list.
Show child attributes
Show child attributes
Primary operating address, sent together with business_address. Provide it only when it differs from the legal address; omitting it keeps a physical address already on file, or uses the legal address when none is set yet.
Show child attributes
Show child attributes
Your own identifier for this entity. Pass the same value to retry safely: a create reusing a reference_id you already used returns the original entity instead of creating a duplicate.
Required string length:
1 - 255Example:
"catnip-coffee-4471"
Response
Successful Response
Public ID of the new business entity. Use it as the entity_id path parameter on the onboarding endpoints, and in the x-entity-id header for entity-scoped requests once the entity is onboarded.
Legal business name.
ISO 8601 timestamp of when the entity was created.