e-Próspera
Reference

Get a legal entity

View as Markdown
GET
/api/v1/legal_entities/{id}

Returns entity identifiers, registration and residency status, jurisdiction, principal office, and the current registered agent with office and mailing addresses. Requires current representation; Agent Keys are additionally restricted to entities created through the Agent API. The UUID id and 14-digit residentPermitNumber are distinct identifiers; no separate registration number is issued by this endpoint.

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

Authorization

AuthorizationBearer <token>

Personal standard API key. Send it as Authorization: Bearer sk-... and never delegate it.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/legal_entities/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "optionId": "string",    "type": "string",    "name": "string",    "extension": "string",    "nameStartsWithExtension": true,    "formationDate": "string",    "registrationDate": "2019-08-24T14:15:22Z",    "dissolutionDate": "2019-08-24T14:15:22Z",    "residentPermitNumber": "string",    "principalOfficeAddress": {      "line1": "string",      "line2": "string",      "city": "string",      "state": "string",      "postalCode": "string",      "country": "string"    },    "createdAt": "2019-08-24T14:15:22Z",    "jurisdictionOfFormation": "string",    "status": "active",    "residencyStatus": "active",    "residency": {      "type": "string",      "effectiveDate": "2019-08-24T14:15:22Z",      "terminationDate": "2019-08-24T14:15:22Z"    },    "registeredAddress": {      "line1": "string",      "line2": "string",      "city": "string",      "state": "string",      "postalCode": "string",      "country": "string"    },    "registeredAgent": {      "providerId": "string",      "name": "string",      "attn": "string",      "website": "string",      "residentPermitNumber": "string",      "effectiveDate": "2019-08-24T14:15:22Z",      "terminationDate": "2019-08-24T14:15:22Z",      "officeAddress": {        "line1": "string",        "line2": "string",        "city": "string",        "state": "string",        "postalCode": "string",        "country": "string"      },      "mailingAddress": {        "line1": "string",        "line2": "string",        "city": "string",        "state": "string",        "postalCode": "string",        "country": "string"      }    }  }}

Check legal-entity name availability POST

Checks for an existing registered name using the same case-insensitive exact-name and entity-option rule as incorporation. Send the name without its legal extension and an optionId (for example llc). Accepts a Standard Key or an Agent Key with agent:registry.search. This read-only check does not reserve a name or guarantee approval; drafts are not reservations, and the check is repeated during incorporation. Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

List documents for a legal entity GET

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.