---
title: "Create compliance data for a user"
method: POST
path: "/v2/payer"
tags: ["Payer", "V2/Payer"]
---

# Create compliance data for a user

`POST /v2/payer`

Checks compliance status and returns necessary URLs for completing compliance.

## Headers

- `x-api-key` string, required

## Request body

- object
  - `clientUserId` string, required — Client User ID
  - `email` string, email, required — Email
  - `firstName` string, required — First Name
  - `lastName` string, required — Last Name
  - `beneficiaryType` 'individual' | 'business', required
  - `companyName` string — Company Name
  - `dateOfBirth` string, required — Date of birth in YYYY-MM-DD format
  - `addressLine1` string, required — Address Line 1
  - `addressLine2` string — Address Line 2
  - `city` string, required — City
  - `state` string, required — State
  - `postcode` string, required — Postcode
  - `country` string, required — Country
  - `nationality` string, required — Nationality
  - `phone` string, required — Phone in E.164 format
  - `ssn` string, required — Social Security Number
  - `sourceOfFunds` string — Source of Funds
  - `businessActivity` string — Business Activity

## Response `200`

Compliance data retrieved successfully

- object
  - `agreementUrl` string, uri
  - `kycUrl` string, uri
  - `status` object, required
    - `agreementStatus` 'not_started' | 'completed', required
    - `kycStatus` 'not_started' | 'completed', required
  - `userId` string, uuid

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized
- `404` — Request not found
- `429` — Too Many Requests

---

[API](https://skmtc.dev/request/apis/request-network-api.md) · [All operations](https://skmtc.dev/request/apis/request-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/request/request-network-api/revisions/042a895ac0c6/schema)
