---
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`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/organizations/{organization-id}/cop-request`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/griffin/apis/the-griffin-api/docs/v0/organizations/:organization-id/cop-request/post.ts> (a function with typed inputs; its response is checked against the schema)

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) An `account-not-found` response also carries a `cop-request-url`. The check reached the payee's provider, and we kept the answer. Attach it to a payee to let your customer decide whether to go ahead. A payee created this way is unverified. 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. Retrying does not always help. Some of these failures are transient, but others are permanent, such as a provider that does not answer CoP checks at all. The response also carries a `cop-request-url`. Attach it to a payee to let your customer decide whether to go ahead. A payee created this way is unverified. See our guide for [verification unavailable](https://docs.griffin.com/docs/guides/confirmation-of-payee#verification-unavailable).

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `post-organizations-organization-id-cop-request` was added
- **2026-08-13** `7da510b95492`: 1 info
  - added the non-success response with the status `503`

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/organizations/:organization-id/cop-request/post.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)