Sign inGet Started
Jetzt starten
Anleitungen
API-Referenz
SDKs
CLI
Wissensdatenbank
Changelog

Get country identification requirements for an eSIM offer

GET
/v1/esim/offers/{offer_id}/requirements
bird esim offers requirements <offer-id>
Antwort200
{
  "countries": [
    {
      "country_code": "US"
    }
  ]
}

Returns identification guidance as a JSON Schema for each country in the offer's coverage zone. The schemas require first_name, last_name, and email, including countries with no additional requirements. Enable format assertions in your validator for email addresses and dates.

You collect and validate the information. Bird does not receive or verify the answers, and fetching or satisfying these schemas does not authorize a purchase or assignment.

Parameter

offer_idstring

Offer ID.

Antwort-Payload

countries
array of object
erforderlich
Untergeordnete Attribute anzeigen
countries.country_code
string
erforderlich

ISO 3166-1 alpha-2 country code.

countries.schema_revision
string
erforderlich

Revision identifying the returned identification schema. A changed revision means the requirements or guidance changed. It does not indicate an expiry time or purchase authorization.

countries.schema
object
erforderlich

Complete JSON Schema draft 2020-12 document for customer-side identification validation. It declares $schema, type, title, description, properties, required, and additionalProperties. Property definitions use string or object types, standard format, pattern, minLength, maxLength, enum, and nested object keywords. Enable format assertions in your validator for email addresses and dates. Every country requires first_name, last_name, and email. Other customer-owned properties are allowed, so one details object can satisfy several countries. Bird does not receive or verify the values. Document references are opaque identifiers in customer-managed storage, not Bird upload IDs or required URLs.

Verwandte Ressourcen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Implementierungs-Briefing erhalten