Skip to main content

Create a SIM card order

POST 
/sim_card_orders

Creates a new order for SIM cards.

Request ​

Body

required

    address_id int64required

    Uniquely identifies the address for the order.

    quantity integerrequired

    Possible values: >= 1

    The amount of SIM cards to order.

Responses ​

200: Successful Response

Schema

    data

    object

    id uuid

    Identifies the resource.

    record_type string

    Identifies the type of the resource.

    quantity integer

    Possible values: >= 1

    The amount of SIM cards requested in the SIM card order.

    cost

    object

    An object representing the total cost of the order.

    amount string

    A string representing the cost amount.

    currency currency

    Filter by ISO 4217 currency string.

    An object representing the total cost of the order.

    order_address

    object

    An object representing the address information from when the order was submitted.

    id int64

    Uniquely identifies the address for the order.

    first_name string

    The first name of the shipping recipient.

    last_name string

    The last name of the shipping recipient.

    business_name string

    The name of the business where the address is located.

    street_address string

    The name of the street where the address is located.

    extended_address string

    Supplemental field for address information.

    locality string

    The name of the city where the address is located.

    administrative_area string

    State or province where the address is located.

    country_code string

    The mobile operator two-character (ISO 3166-1 alpha-2) origin country code.

    postal_code string

    Postal code for the address.

    An object representing the address information from when the order was submitted.

    tracking_url url

    The URL used to get tracking information about the order.

    status string

    Possible values: [pending, processing, ready_to_ship, shipped, delivered, canceled]

    The current status of the SIM Card order.

    • pending - the order is waiting to be processed.
    • processing - the order is currently being processed.
    • ready_to_ship - the order is ready to be shipped to the specified address.
    • shipped - the order was shipped and is on its way to be delivered to the specified address.
    • delivered - the order was delivered to the specified address.
    • canceled - the order was canceled.

    created_at string

    ISO 8601 formatted date-time indicating when the resource was last created.

    updated_at string

    ISO 8601 formatted date-time indicating when the resource was last updated.

401: Unauthorized

default: Unexpected error

Schema

    errors

    Error[]

  • Array [

    • code intrequired
    title stringrequired
    detail string

    source

    object

    pointer json-pointer

    JSON pointer (RFC6901) to the offending entity.

    parameter string

    Indicates which query parameter caused the error.

    meta object

  • ]

Request samples

curl -L 'https://api.telnyx.com/v2/sim_card_orders' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "address_id": "1293384261075731499",
  "quantity": 23
}'

Response samples

{
  "data": {
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "record_type": "sim_card_order",
    "quantity": 21,
    "cost": {
      "amount": "2.52",
      "currency": "USD"
    },
    "order_address": {
      "id": "1293384261075731499",
      "street_address": "311 W Superior St",
      "extended_address": "Suite 504",
      "locality": "Chicago",
      "administrative_area": "IL",
      "country_code": "US",
      "postal_code": "60654"
    },
    "tracking_url": "http://www.example.com/",
    "status": "pending",
    "created_at": "2018-02-02T22:25:27.521Z",
    "updated_at": "2018-02-02T22:25:27.521Z"
  }
}