Sign inGet Started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

Get country identification requirements for an eSIM offer

GET
/v1/esim/offers/{offer_id}/requirements
bird esim offers requirements <offer-id>
Odpowiedź200
{
  "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.

Parametry

offer_idstring

Offer ID.

Treść odpowiedzi

countries
array of object
wymagane
Pokaż atrybuty podrzędne
countries.country_code
string
wymagane

ISO 3166-1 alpha-2 country code.

countries.schema_revision
string
wymagane

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
wymagane

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.

Powiązane zasoby

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.

Uzyskaj brief wdrożeniowy