---
title: "Get certificate metadata"
method: GET
path: "/v1/signatures/{signatureId}/certificateInformation"
tags: ["Qualified Electronic Signature"]
---

# Get certificate metadata

`GET /v1/signatures/{signatureId}/certificateInformation`

Use this endpoint to return the certificate metadata generated for a signature after the signing process is completed.<br /><br /><img src="https://files.readme.io/310d4d3-Inline_Caution.svg" align="left" alt="Important" /> **Important:** This endpoint can only be called when the signature [status](https://docs.fourthline.com/docs/qes-statuses) is `signed`. Otherwise, the API returns a `400 Bad Request` response.

## Path parameters

- `signatureId` string, required

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Response `200`

The certificate metadata was retrieved successfully

- object
  - `certificateId` string, uuid, nullable — Unique identifier of the certificate.
  - `certificateType` string, nullable — Type of the certificate. <br /> Possible values `DISPOSABLE` or `LONG-LIVED`.
  - `serialNumber` string, nullable — Serial number of the certificate.
  - `createdDate` string, date-time, nullable — Date and time when the certificate was created.
  - `certificateData` object — Certificate holder information.
    - `firstName` string — The client’s first name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: John
    - `lastName` string — The client’s last name. <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: Smith
    - `phoneNumber` string — The client’s mobile phone number, which you have ensured is valid. <br /><br />Format: +{prefixNumber} {phoneNumber} <br /><img src="https://files.readme.io/ad2486a-Inline_Note.svg" align="left"/> **Notes**: <br />• Always include a **space** between the prefix and phone number. <br />• The prefix can contain a maximum of **4** digits. <br /><br />Example: `+31 612345678`
    - `email` string — The client’s email address. <br /><br />Format: Maximum 254 characters [_-a-zA-Z0-9.+]+@a-zA-Z0-9 <br /><br />Example: `j.smith@example.com`
    - `documentNumber` string — The number of the client’s <Glossary>ID document</Glossary>.
    - `documentType` string — The type of identity file. Returned as a human-readable string in [Get case status](https://docs.fourthline.com/reference/get-case-status) and the [XML report](https://docs.fourthline.com/docs/reports#xml-file). <br />Enum: <br />• `Business Card` <br />• `Document Video` <br />• `Driving License` <br />• `Embedded Face` <br />• `Health Insurance Card` <br />• `IBAN Statement` <br />• `National ID Card` <br />• `Other` <br />• `Paper ID` <br />• `Passport` <br />• `Proof of Residence` <br />• `Residence Permit` <br />• `Selfie` <br />• `Selfie Video` <br />• `SSN Reference Document` <br />• `Student ID Card` <br />• `TIN Reference Document`
    - `issuingCountry` string — The country that issues the ID documents. <br /><br />Format: ISO 3166-1 alpha-3
    - `issuingDate` string — The date the ID document was issued. <br /><br />Format: YYYY-MM-DD <br /><br />Requirements: ID documents with an issue date. Otherwise optional for identity files without an issue date <br />If **not** provided, the value returned is `0000-01-01`
    - `expirationDate` string — The date the ID document expires. <br /><br />Format: YYYY-MM-DD <br /><br />Requirements: ID documents with an expiry date. Otherwise optional for identity files without an expiry date <br />If **not** provided, the value returned is `0000-01-01`

## Other responses

- `400` — Invalid request parameters
- `404` — Signature not found

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)