Verification Detail

Create a verification detail

Creates a new verification detail

<p class="notice--warning"><strong>Warning</strong>: This endpoint only supports UK based limited companies. Therefore the creditor's `creditor_type` must be `'company'` and `country_code` must be `'GB'`.</p>
post/verification_details

Request

  • Base URL
    https://api.gocardless.com
  • Auth
    HTTP bearer

Headers

GoCardless-Versionstring required

Request body

Example request

{
  "verification_details": {
    "name": "Acme Limited",
    "company_number": "07495895",
    "description": "Wine and cheese seller",
    "address_line1": "338-346 Goswell Road",
    "address_line2": "Islington",
    "city": "London",
    "postal_code": "EC1V 7LQ",
    "directors": [
      {
        "given_name": "Tom",
        "family_name": "Jones",
        "date_of_birth": "1986-02-19",
        "city": "London",
        "postal_code": "EC1V 7LQ",
        "country_code": "GB"
      }
    ],
    "links": {
      "creditor": "CR123"
    }
  }
}

Response

Resource created successfully

Example response

{
  "verification_details": {
    "name": "Acme Limited",
    "company_number": "07495895",
    "description": "Wine and cheese seller",
    "address_line1": "338-346 Goswell Road",
    "address_line2": "Islington",
    "city": "London",
    "postal_code": "EC1V 7LQ",
    "region": "Essex",
    "country_code": "GB",
    "directors": [
      {
        "given_name": "Tom",
        "family_name": "Jones",
        "date_of_birth": "1986-02-19",
        "city": "London",
        "postal_code": "EC1V 7LQ",
        "country_code": "GB"
      }
    ],
    "links": {
      "creditor": "CR123"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.