---
title: "List verification details"
method: GET
path: "/verification_details"
tags: ["Verification Detail"]
---

# List verification details

`GET /verification_details`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/verification_details`
- Auth: HTTP bearer

Returns a list of verification details belonging to a creditor.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `creditor` string, required: Unique identifier, beginning with "CR".

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- VerificationDetailMultiResourceResponse: A list of verification details
  - `verification_details` VerificationDetail[]
    - `name` string, required: The company's legal name.
    - `company_number` string, required: The company's registration number.
    - `description` string, required: A summary describing what the company does.
    - `address_line1` string, required: The first line of the company's address.
    - `address_line2` string, nullable, required: The second line of the company's address.
    - `address_line3` string, nullable, required: The third line of the company's address.
    - `city` string, required: The city of the company's address.
    - `postal_code` string, required: The company's postal code.
    - `region` string, nullable, required: The region of the company's address.
    - `country_code` string, required: The country code of the company's address.
    - `directors` VerificationDetailDirector[], required: The company's directors.
      - `given_name` string, required: The person's given name.
      - `family_name` string, required: The person's family name.
      - `date_of_birth` string, required: The person's date of birth.
      - `street` string, required: The street of the person's address.
      - `city` string, required: The city of the person's address.
      - `postal_code` string, required: The person's postal code.
      - `country_code` string, required: [ISO 3166-1 alpha-2 code.](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
    - `links` VerificationDetailLinks, required
      - `creditor` string: ID of the [creditor](https://docs.gocardless.com/docs/api-reference/creditor)
  - `meta` VerificationDetailPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)