Skip to main content
GET
/
entities
/
all
cURL
curl --request GET \
  --url https://api.getenso.ai/entities/all \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Success",
  "data": [
    {
      "id": "ent_123",
      "entityFor": "customer",
      "legalName": "Acme Inc",
      "alias": "acme",
      "email": [
        "[email protected]"
      ],
      "phoneNumber": "+1-415-555-0100",
      "Organisation": {
        "id": "org_123",
        "name": "Acme Org"
      },
      "Customer": {
        "id": "cus_123",
        "name": "Acme Customer"
      },
      "Addresses": [
        {
          "id": "addr_123",
          "line1": "123 Market St",
          "city": "San Francisco",
          "State": {
            "id": "st_123",
            "name": "California",
            "Country": {
              "id": "ct_123",
              "name": "United States"
            }
          }
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
type
string

Entity type to filter by (mapped to entityFor). Possible values: customer, organisation.

Example:

"customer"

​
keyword
string

Optional keyword to match legalName or alias.

Example:

"acme"

Response

Success. Returns a list of entities.

​
status
string
​
message
string
​
data
object[]