Bridge
Contact us
API reference · Identity & onboarding

Attestations

POST Record an attestation for an account holder

POST /accountholder/{type}/{value}/attestation

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
type
value

Example

Request body: AttestationRequest · Response: GenericResponseAttestationResponse

curl -X POST "https://api.bridgemoni.com/accountholder/value/value/attestation" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "attestationType": "IDENTITY",
  "attestedResource": "PERSON",
  "attestedRowReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attestorUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attestorName": {
    "name": "string"
  },
  "attestorRole": "TRADITIONAL_RULER",
  "attestorInstitution": {
    "name": "string"
  },
  "attestorInstitutionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attestorIal": "1",
  "statement": "string",
  "expiresDateTime": "2026-09-25T10:00:00Z",
  "evidenceDocumentReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "signatureReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

Responses

StatusWhen
200An attestation recorded successfully

GET List an attestation for an account holder

GET /accountholder/{type}/{value}/attestations

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
type
value

Example

Response: GenericResponseListAttestationResponse

curl -X GET "https://api.bridgemoni.com/accountholder/value/value/attestations" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200An attestation fetched successfully

GET Fetch one record

GET /attestation/{id}

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
id

Example

Response: GenericResponseAttestationResponse

curl -X GET "https://api.bridgemoni.com/attestation/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200An attestation fetched successfully

PUT Withdraw an attestation

PUT /attestation/{id}

An attestation is withdrawn, never deleted. The row stays and reads back live: false, so a vouch count that used to include it changes and the reason it changed is still readable.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
id

Example

Request body: WithdrawAttestationRequest · Response: GenericResponseAttestationResponse

curl -X PUT "https://api.bridgemoni.com/attestation/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "withdrawalReason": "string"
}'

Responses

StatusWhen
200An attestation withdrawn successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors