Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

Send install credentials to the traveler

POST
/v1/esim/sims/{esim_id}/credentials/deliver
bird esim credentials deliver <esim-id> \
  --channel sms \
  --locale nl \
  --to +31612345678
प्रतिक्रिया202
{
  "id": "edv_01krdgeqcxet5s7t44vh8rt9mg",
  "channel": "email",
  "to": "traveler@example.com",
  "status": "pending",
  "failure_code": "invalid_recipient",
  "install_link": {
    "id": "eil_01krdgeqcxet5s7t44vh8rt9mg"
  }
}

Sends a hosted installation link by email or SMS. The eSIM must be installable. Email includes the link expiry time; SMS includes the link. The recipient opens the page to view the QR code and manual installation details. Links expire after seven days; resending leaves earlier links valid until expiry or explicit revocation.

A 202 response confirms acceptance for sending. Check List credential deliveries for the delivery outcome and any failure code. Reuse the same Idempotency-Key to recover an accepted send while its response is retained.

Returns 409 with E26012 when the selected channel is unavailable; choose another configured channel. New deliveries return 501 while hosted links are unavailable. A retained successful response can still be replayed during that time.

पैरामीटर

esim_idstring

eSIM ID.

Request Payload

to
string
आवश्यक

Recipient address. An email address for the email channel, an E.164 phone number for the sms channel.

channel
string
आवश्यक

Channel the install credentials are delivered over.

Possible values: email, sms

locale
string

Language for the message. Falls back to the closest available language, then English.

Response Payload

id
string
आवश्यक
channel
string
आवश्यक
to
string
आवश्यक

Recipient address the message goes to.

status
string
आवश्यक
failure_code
nullable string
आवश्यक

Why the delivery failed. Null unless status is failed. Open enum: treat unrecognized values as future failure kinds.

Possible values (may grow over time): invalid_recipient, suppressed, blocked, bounced, channel_unavailable, send_failed

created_at
string
आवश्यक

When the delivery was accepted.

settled_at
nullable string
आवश्यक

When the outcome became known. Null while pending.

install_link
nullable object
आवश्यक

Link metadata for explicit revocation. Null for deliveries created before hosted links were enabled.

चाइल्ड एट्रिब्यूट दिखाएँ
install_link.id
string
आवश्यक
install_link.expires_at
string
आवश्यक

When the installation link expires.

install_link.revoked_at
nullable string
आवश्यक

When the link was revoked, or null while not revoked.

संबंधित संसाधन

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ