Bridge
Contact us
API reference · Identity & onboarding

Attestation requests

POST Ask somebody to vouch for an account holder

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

Composes the exact statement the attestor will be asked to sign — not a blanket endorsement. The attestor may accept, decline, or correct the relationship duration. Declining is silent: the person who asked is told the request closed, never that it was refused.

Headers

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

Path parameters

Name
type
value

Example

Request body: AttestationRequestRequest · Response: GenericResponseAttestationRequestResponse

curl -X POST "https://api.bridgemoni.com/accountholder/value/value/attestation/request" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "attestorUserReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "attestorMsisdn": "string",
  "attestorName": {
    "name": "string"
  },
  "attestationType": "IDENTITY",
  "attestedResource": "PERSON",
  "attestationBasis": "SAME_HOUSEHOLD",
  "basisAddressReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "basisEmployerReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "claimedKnownSinceDate": "2026-09-25"
}'

Responses

StatusWhen
200Attestation requested successfully

PUT Answer an attestation request

PUT /accountholder/{type}/{value}/attestation/request/{id}

Accept, decline, or accept with a corrected relationship duration. An attestor below IAL2 is refused — somebody barely identified themselves cannot lend assurance to another. The attestor also chooses here whether they may be named on release.

Headers

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

Path parameters

Name
type
value
id

Example

Request body: AttestationResponseRequest · Response: GenericResponseAttestationRequestResponse

curl -X PUT "https://api.bridgemoni.com/accountholder/value/value/attestation/request/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 '{
  "accepted": "true",
  "correctedKnownSinceDate": "2026-09-25",
  "attestorVisibility": "NAMED",
  "attestorIal": "1"
}'

Responses

StatusWhen
200Attestation request answered successfully

GET List the attestation requests an account holder has raised

GET /accountholder/{type}/{value}/attestation/requests

Headers

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

Path parameters

Name
type
value

Example

Response: GenericResponseListAttestationRequestResponse

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

Responses

StatusWhen
200Attestation requests fetched successfully

GET List the attestation requests waiting on an account holder to answer

GET /accountholder/{type}/{value}/attestation/requests/incoming

Headers

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

Path parameters

Name
type
value

Example

Response: GenericResponseListAttestationRequestResponse

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

Responses

StatusWhen
200Attestation requests fetched successfully

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