Get an entity
The business with its kind and its current certificate, if it has one. To find out what it still needs before issuing, use GET /v1/ec/entities/{id}/readiness.
Your API key, which acts for the one business it was created for: fb_sandbox_… issues in sandbox, fb_test_… in test, the tax authority's testing service, and fb_live_… in live.
In: header
Path Parameters
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/ec/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "entity", "kind": "sandbox", "country": "ec", "ruc": "string", "legal_name": "string", "trade_name": "string", "head_office_address": "string", "head_office_phone": "string", "head_office_email": "string", "reply_to_email": "string", "footer_legend": "string", "keeps_accounting": true, "regime": "general", "special_taxpayer_resolution": "string", "withholding_agent_resolution": "string", "large_taxpayer_resolution": "string", "certificate": { "holder": "string", "holder_identification": "string", "holder_identification_type": "cedula", "kind": "natural_person", "issuer_name": "string", "subject": "string", "issuer": "string", "serial_number": "string", "valid_from": "2019-08-24T14:15:22Z", "valid_until": "2019-08-24T14:15:22Z" }, "portal_shows_test": true, "live_since": "2019-08-24T14:15:22Z", "issuing": { "allowed": true, "lock": { "code": "plan_required", "message": "string", "canceled": true } }, "logo": { "url": "http://example.com", "content_type": "image/png", "size": 0 }, "created_at": "2019-08-24T14:15:22Z"}List entities GET
With a key, its own business alone: a key acts for one. With a person's session, the organization's practice and live businesses, each with its `kind`.
Update an entity PATCH
Only the fields you send change. On a `live` business, the legal name, the regime and whether it keeps accounting come from the SRI registry and cannot be edited (`422`). Documents already issued keep the data they were signed with.