Certificates

Check a certificate or MPI Report

Verifies an MPI Report certificate by its public id and answers exactly what the public verification at /v1/public/certificates/ answers: the public view of a certificate that is not revoked (the holder’s name as printed on it, the score and percentile at issue, the phase, the highest class, the stored status, and the issue and expiry instants), never the holder’s account or contact. The id is trimmed and upper-cased; an unknown, revoked or malformed id answers 404 not_found, the three alike. status is the stored one: compare expires_at with the current time to show expiry by date. The call needs no grant and no scope; like every partner call it counts toward the daily allowance and is logged.

GET

partner

certificates

{certificate_id}

Check a certificate or MPI Report

curl --request GET \
  --url https://{devApiHost}/v1/partner/certificates/{certificate_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{devApiHost}/v1/partner/certificates/{certificate_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{devApiHost}/v1/partner/certificates/{certificate_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "certificate_id": "MPI-2026-AMEL-000412",
  "pilot_name": "Ana Souza",
  "score_at_issue": 512.4,
  "percentile_at_issue": 70,
  "score_category": "Positioning",
  "phase_color": "#fbbf24",
  "highest_class": "AMEL",
  "status": "active",
  "issued_at": "2026-01-02T03:04:05Z",
  "expires_at": "2027-01-02T03:04:05Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Resource not found.",
    "correlation_id": "0af7651916cd43dd8448eb211c80319c"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "rate_limited"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Request a token from the token endpoint of the identity provider's domain (https://{cognito-domain}/oauth2/token, with HTTP Basic client authentication) and send it as a Bearer token. Production uses auth.mypilotindex.com. The sandbox uses the dev environment's Cognito domain, which is given to the partner with its sandbox credential. A token carries only the scopes the partner was approved for.

Path Parameters

certificate_id

string

required

The public certificate id: MPI, the four-digit year, the class (AMEL, AMES, ASEL, ASES or GENL) and a sequence of six to nine digits, joined by hyphens (MPI-2026-AMEL-000412). Surrounding whitespace is ignored and letters are upper-cased; anything longer than 64 bytes or outside the issued format is treated as unknown.

Response

The public view of the certificate.

The public view of an MPI Report certificate, the answer of the public verification.

certificate_id

string

required

pilot_name

string

required

The holder's name as printed on the certificate.

score_at_issue

number

required

percentile_at_issue

integer

required

Required range: 0 <= x <= 100

score_category

string

required

phase_color

string

required

highest_class

enum<string>

required

Available options:

AMEL,

AMES,

ASEL,

ASES,

GENL

status

enum<string>

required

The stored status; compare expires_at with the current time to show expiry by date.

Available options:

active,

expired

issued_at

string<date-time>

required

expires_at

string<date-time>

required

⌘I

Check a certificate or MPI Report

curl --request GET \
  --url https://{devApiHost}/v1/partner/certificates/{certificate_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{devApiHost}/v1/partner/certificates/{certificate_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{devApiHost}/v1/partner/certificates/{certificate_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "certificate_id": "MPI-2026-AMEL-000412",
  "pilot_name": "Ana Souza",
  "score_at_issue": 512.4,
  "percentile_at_issue": 70,
  "score_category": "Positioning",
  "phase_color": "#fbbf24",
  "highest_class": "AMEL",
  "status": "active",
  "issued_at": "2026-01-02T03:04:05Z",
  "expires_at": "2027-01-02T03:04:05Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Resource not found.",
    "correlation_id": "0af7651916cd43dd8448eb211c80319c"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "rate_limited"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "correlation_id": "<string>",
    "reason": "<string>"
  }
}

Overview

Grants

Certificates

Webhooks

Check a certificate or MPI Report

Authorizations

Path Parameters

Response