entity.legalAPI Documentation

API Reference

Incorporate legal entities programmatically. One POST request = one entity.

Base URL

https://api.entity.legal

Authentication

Authorization: Bearer YOUR_API_KEY

API keys are not yet available. Join the waitlist to request access.

POST/v1/incorporatepreview

Form a new legal entity in the Marshall Islands.

Request

curl -X POST https://api.entity.legal/v1/incorporate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "for-profit",
    "name": "My Entity LLC",
    "shares": { "class_a": 1000, "class_b": 0 }
  }'

Response

{
  "status": "queued",
  "entity_id": "ent_a1b2c3d4",
  "jurisdiction": "Marshall Islands",
  "structure": "Series DAO LLC",
  "name": "My Entity LLC",
  "tax_id": "MH-2026-XXXXX",
  "shares": {
    "class_a": 1000,
    "class_b": 0
  }
}
GET/v1/entities/:idcoming soon

Retrieve entity details including status, formation date, and share structure.

Request

curl https://api.entity.legal/v1/entities/ent_a1b2c3d4 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "ent_a1b2c3d4",
  "name": "My Entity LLC",
  "status": "active",
  "jurisdiction": "Marshall Islands",
  "type": "for-profit",
  "formed_at": "2026-02-28T00:00:00Z",
  "tax_id": "MH-2026-XXXXX",
  "shares": {
    "class_a": { "total": 1000, "holders": 1 },
    "class_b": { "total": 0, "holders": 0 }
  }
}
GET/v1/entities/:id/sharescoming soon

View the on-chain cap table — all shareholders and their holdings.

Request

curl https://api.entity.legal/v1/entities/ent_a1b2c3d4/shares \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "entity_id": "ent_a1b2c3d4",
  "total_shares": 1000,
  "classes": [
    {
      "class": "A",
      "type": "voting",
      "total": 1000,
      "holders": [
        { "address": "0x...", "amount": 1000 }
      ]
    }
  ],
  "registry": "solana",
  "registry_address": "..."
}

Try it now — no API key needed during preview:

curl -X POST https://api.entity.legal/v1/incorporate