⚠️ iOS/iPadOS/tvOS only.

Retrieves the metadata record for a specific APNs certificate by its UUID.Returns a single APNSCertInfo object with the certificate's state, associated Apple ID, APNs topic, creation and expiry timestamps, and audit fields.

About Get APNs Certificate

Direct lookup for a single APNs certificate record, returning the same APNSCertInfo schema as the list endpoint. Use this endpoint to check the state and expiry of a specific certificate when its id is already known — for example, after generating a CSR to confirm the record was created, or to check meta.cert_expiry_on for renewal planning. A state of CSR_GENERATED indicates the setup workflow has been started but the signed certificate has not yet been uploaded; COMPLETED means the certificate is active.

Key Fields

id (path) — APNs certificate record UUID (required)

state — CSR_GENERATED or COMPLETED

apple_id — Apple ID associated with the certificate

meta.topic — APNs topic string

meta.cert_expiry_on — Certificate expiry datetime

meta.cert_created_at — Certificate creation timestamp at Apple

Common Use Cases

Confirming a new APNs certificate record was created after calling the CSR generation endpoint

Checking the expiry date of a specific active certificate for renewal scheduling

Verifying the Apple ID and topic for a certificate before renewal

Best Practices

Use meta.cert_expiry_on to schedule renewal — APNs certificates expire annually and must be renewed before expiry to maintain iOS device management

If state is CSR_GENERATED and no PUT has been performed, the certificate setup is incomplete — proceed with uploading the signed certificate via PUT /api/tenant/v0/apnscertificates/{id}/