---
title: "Get APNs certificate meta information"
method: GET
path: "/tenant/v0/apnscertificates/{id}/"
tags: ["tenant_APNs certificate"]
---

# Get APNs certificate meta information

`GET /tenant/v0/apnscertificates/{id}/`

⚠️ 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}/

## Path parameters

- `id` string, required

## Response `200`

APNs certificate meta information

- object
  - `code` integer
  - `message` string
  - `content` TenantAPNSCertInfo
    - `id` string
    - `apple_id` string
    - `meta` object
      - `topic` string
      - `cert_created_at` string, date-time
      - `cert_expiry_on` string, date-time
    - `state` 'CSR_GENERATED' | 'COMPLETED' — state of APNs certificate upload
    - `created_by` number
    - `updated_by` number
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/versions/e1f64cbb488e/schema)