---
title: "Create a CoP request"
method: POST
path: "/v0/organizations/{organization-id}/cop-request"
tags: ["Confirmation of payee"]
---

# Create a CoP request

`POST /v0/organizations/{organization-id}/cop-request`

Create a Confirmation of Payee (CoP) request.

## Path parameters

- `organization-id` string, required

## Request body

- object
  - `account-number` string, required — A UK account number.
  - `bank-id` string, required — A UK sort code.
  - `account-classification` 'personal' | 'business', required
  - `name` string, required — The name of the payee.
  - `requester-legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
    - string
    - string
  - `secondary-reference-data` string — Secondary reference data, such as a building society roll number or a credit card number.

## Response `201`

Created

- object
  - `cop-request-url` union, required — Link to a [CoP request](#tag/Confirmation-of-payee).
    - string
    - string
  - `account` object, required — The payee's account details.
    - `account-number` string, required — A UK account number.
    - `bank-id` string, required — A UK sort code.
    - `account-classification` 'personal' | 'business', required
    - `name` string, required — The name of the payee.
    - `requester-legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
      - string
      - string
    - `secondary-reference-data` string — Secondary reference data, such as a building society roll number or a credit card number.
  - `cop-response` object, required — The outcome of the CoP request
    - `status` 'verified' | 'unverified', required
    - `result` 'match' | 'close-match' | 'no-match', required
    - `reason` 'no-match-name' | 'account-not-supported' | 'match-name-business-personal' | 'match-name-personal-business' | 'close-match-name-business-personal' | 'no-match-secondary-ref' | 'close-match-name' | 'account-switched' | 'close-match-name-personal-business'
    - `suggested-name` string — The suggested name of the payee. Only present on a close match.
    - `suggested-account-classification` 'personal' | 'business' — The suggested account classification. Only present on a close match.

## Other responses

- `400` — Bad Request is served if: * we couldn't find a valid account matching those details (`account-not-found`) * the `requester-legal-person-url` is not a legal person we recognise (`legal-person-not-found`) * the request body does not conform to the schema (no `code` is served) See our guide for [confirmation of payee](https://docs.griffin.com/docs/guides/confirmation-of-payee).
- `401` — Requires an API key to continue
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `503` — We couldn't perform verification at this time, please retry later. See our guide for [verification unavailable](https://docs.griffin.com/docs/guides/confirmation-of-payee#verification-unavailable).

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/7da510b95492/schema)