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

# Get certificate metadata

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

## Request

- Base URL: `https://api.ext-sandbox.fourthline.com`
- URL: `https://api.ext-sandbox.fourthline.com/v1/signatures/{signatureId}/certificateInformation`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://example.com/token`

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](ref: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
    - `middleName` string: The client’s middle name(s). <br /><br />Format: Alphabetical characters, spaces, hyphens, and apostrophes <br /><br />Example: James
    - `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](ref: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

## Changes

- **2026-11-03** `87907b6e3164`: 1 info
  - added the optional property `certificateData/middleName` to the response with the `200` status

[Operation history](https://skmtc.dev/fourthline/apis/fourthline-apis/changes/v1/signatures/:signatureId/certificateInformation/get.md)

---

[API](https://skmtc.dev/fourthline/apis/fourthline-apis.md) - [All operations](https://skmtc.dev/fourthline/apis/fourthline-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthline/apis/fourthline-apis/revisions/87907b6e3164?raw)