Skip to main content

Entity Setup

Set up the foundational entities required for EU tax compliance.

1. Create Account​

Endpoint: POST /api/entity/v1/accounts/

curl -X POST https://api.abacus.com/api/entity/v1/accounts/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Example Group Account",
  "managed_service_provider": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "country": "US"
}'

Response:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Example Group Account",
  "country": "US",
  "created_at": "2025-07-02T10:00:00Z"
}
info

The managed_service_provider value will be unique to your tax engine and should always be used when creating a new account

2. Create Entity​

Endpoint: POST /api/entity/v1/entities/

curl -X POST https://api.abacus.com/api/entity/v1/entities/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "EU Operations Ltd",
    "country": "IE",
    "city": "Dublin",
    "street_number": "1234",
    "street_name": "Street Avenue",
    "suburb": "South Dublin",
    "zip_code": "6321"
  }'

Response:

{
  "id": "e1f2g3h4-i5j6-7890-klmn-op1234567890",
  "account": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "EU Operations Ltd",
  "country": "IE",
  "created_at": "2025-07-02T10:05:00Z"
}

3. Create Registration​

Endpoint: POST /api/registrations/v1/registrations/

curl -X POST https://api.abacus.com/api/registrations/v1/registrations/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "DE12345678",
  "date_of_registration": "2025-07-03",
  "date_registration_closed": "2025-07-03",
  "date_of_filing_start": "2025-07-03",
  "fiscal_representative_type": "not_required",
  "registration_type": "standard",
  "taxable_jurisdiction": "DE",
  "entity": "e1f2g3h4-i5j6-7890-klmn-op1234567890"
}'

Response:

{
  "id": "r1s2t3u4-v5w6-7890-xyz1-23456789abcd",
  "entity_jurisdiction": "ej123456-7890-abcd-ef12-34567890abcd",
  "entity": "e1f2g3h4-i5j6-7890-klmn-op1234567890",
  "jurisdiction_iso": "DE",
  "number_local": "DE123456789",
  "registration_type": "standard",
  "date_of_registration": "2025-07-02",
  "created_at": "2025-07-02T10:10:00Z"
}

Important Notes​

  • Save the entity_jurisdiction ID - Required for all transaction submissions
  • Each EU country requires a separate registration
  • Registration creates the Entity Jurisdiction (EJ) automatically
  • EJ format: entity_id + jurisdiction_iso for identification