Skip to main content

Entities

POST /v1/entities​

Explicitly create an entity that doesn't exist in source registries — for example, a subcontractor not registered in SAM.gov.

note

For entities already in SAM.gov, use POST /v1/entities/lookup instead. Explicit creation is for the minority of vendors not covered by authoritative sources.

Request​

{
  "legal_name": "Subcontractor Services LLC",
  "identifiers": [
    { "type": "tin", "value": "98-7654321" }
  ],
  "address": {
    "line1": "456 Oak Ave",
    "city": "Arlington",
    "state": "VA",
    "zip": "22201",
    "country": "US"
  }
}

Response — 201​

Returns the created entity in the same shape as POST /v1/entities/lookup.

Every entity creation captures an immutable entity_snapshots row for audit purposes.

GET /v1/entities/:id​

Fetch a single entity by ID.

Response — 200​

Same shape as the lookup response.

Response — 404​

{ "error": "entity_not_found", "message": "Entity not found." }

POST /v1/verifications​

Run verification against an already-resolved entity without the lookup-or-create convenience of /v1/verify.

Request​

{
  "entity_id": "ent_01abc...",
  "checks": ["sam_registration"],
  "mode": "realtime"
}

Response​

Same shape as POST /v1/verify.