---
title: "Submit Agreement Attestations"
method: POST
path: "/api/identity-service/v1/identities/{identityId}/agreements"
tags: ["Know Your Business (KYB)"]
---

# Submit Agreement Attestations

`POST /api/identity-service/v1/identities/{identityId}/agreements`

Submit one or more agreement attestations for an identity. Each submission is validated against document-service before being stored.

## Path parameters

- `identityId` string, uuid, required

## Request body

- object[]
  - `agreementId` 'amlAttestation' | 'nonSolicitationLetterEu' | 'nonSolicitationLetterSg', required — The agreement type being attested
  - `revision` integer, required — The revision number of the agreement content
  - `attested` boolean, required — Whether the user attested to this agreement
  - `attestationDate` string, date-time, required — ISO 8601 timestamp of when the attestation occurred

## Response `201`

201

- object
  - `identityId` string, uuid, required — The identity ID
  - `acceptedAgreements` object[], required — Successfully accepted agreements
    - `id` string, required — Internal ID for the agreement association
    - `agreementId` 'amlAttestation' | 'nonSolicitationLetterEu' | 'nonSolicitationLetterSg', required — The agreement type attested
    - `revision` integer, required — Revision number at time of attestation
    - `attested` boolean, required — Whether the user attested to this agreement
    - `attestationDate` string, date-time, required — ISO 8601 timestamp of attestation
    - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Status of the agreement
    - `attestedByUserId` string, nullable, required — BitGo user ID of the user who attested, from request context
    - `createdAt` string, required — ISO timestamp when agreement was created
    - `updatedAt` string, required — ISO timestamp when agreement was last updated

## Other responses

- `400` — 400
- `401` — 401
- `404` — 404
- `429` — 429
- `500` — 500
- `503` — 503

## Changes

- **2026-09-05** `abacf80da2fd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitgo/apis/bitgo-api/changes/api/identity-service/v1/identities/:identityId/agreements/post.md)

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/20d885ca364f?raw)