Skip to main content
PATCH
/
v1
/
entities
/
{entityId}
Update
curl --request PATCH \
  --url https://api.cadanapay.com/v1/entities/{entityId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalName": "Acme Corp Ghana Updated",
  "entityType": "limited liability company",
  "address": {
    "countryCode": "US",
    "line1": "Street 1",
    "line2": "Apt 1",
    "city": "Gotham",
    "postalCode": "10001",
    "state": "NY"
  },
  "phoneNumber": {
    "countryCode": "1",
    "number": "2345678901"
  },
  "registrationNumber": "BN-654321",
  "taxId": "TIN-210987",
  "incorporationDate": "2019-06-01"
}
'
{
  "code": "invalid_request_body",
  "message": "The request body provided is not valid",
  "params": {
    "field": "Value is invalid."
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

​
entityId
string<uuid>
required

The unique identifier of the entity

Body

application/json

Update entity request payload (partial update)

​
legalName
string

Legal name of the entity

Example:

"Acme Corp Ghana Updated"

​
entityType
enum<string>

Legal structure type

Available options:
corporation,
c-corporation,
s-corporation,
partnership,
sole proprietorship,
limited liability company,
non profit,
other
Example:

"limited liability company"

​
address
object

Address

​
phoneNumber
object

Person's phone number

​
registrationNumber
string

Business registration number

Example:

"BN-654321"

​
taxId
string

Tax identification number

Example:

"TIN-210987"

​
incorporationDate
string

Date of incorporation (YYYY-MM-DD)

Example:

"2019-06-01"

Response

Successful operation