---
title: "Get user data by mandate ID"
method: GET
path: "/mandates"
tags: ["User Data"]
---

# Get user data by mandate ID

`GET /mandates`

Get user data from a authorized mandate.

## Query parameters

- `mandate_id` string, required

## Response `200`

Success

- User
  - `title` string — Title
  - `first_name` string — User first name
  - `last_name` string — User last name
  - `date_of_birth` string — User Date Of Birth, formatted as an ISO 8601 string `YYYY-MM-DD`
  - `address` object — User address
    - `address_line1` string — the full street address including house number and street name
    - `address_line2` string — further details like building name, suite, apartment number, etc.
    - `city` string — name of the city / locality
    - `state` string — name of the county / state
    - `zip` string — zip code or postal code
    - `country_code` string — the country code according to [iso-3166-1-alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
  - `national_identification_number` string — User national identification number (**available in Finland only**)
  - `sex` string — Sex of the user (**available in Finland only**)
  - `account_details` object — User account details
    - `account_number` string — The account number.
    - `sort_code` string — Sort code of account.
    - `iban` string — Accounts IBAN number.
    - `provider_id` string — The name of the bank.

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Mandate not found
- `422` — Mandate is in an invalid state/Invalid data
- `500` — Internal Server Error

---

[API](https://skmtc.net/truelayer/apis/authentication-server.md) · [All operations](https://skmtc.net/truelayer/apis/authentication-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truelayer/authentication-server/revisions/5f6051515b2c/schema)