Get country identification requirements for an eSIM offer
/v1/esim/offers/{offer_id}/requirementsbird esim offers requirements <offer-id>curl -X GET "https://us1.platform.bird.com/v1/esim/offers/{offer_id}/requirements" \
-H "Authorization: Bearer $TOKEN"{
"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.
参数
offer_idstringOffer ID.
响应载荷
countries显示子属性
countries.country_codeISO 3166-1 alpha-2 country code.
countries.schema_revisionRevision 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.schemaComplete 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.