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 /v1/partner/certificates/{certificate_id}

Check a certificate or MPI Report

cURL

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

200

{
  "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"
}

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

200

application/json

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