Get all SIM card groups

GET 
/sim_card_groups

Get all SIM card groups belonging to the user that match the given filters.

Query Parameters

page[number] integer

Possible values: >= 1

Default value: 1

The page number to load.

page[size] integer

Possible values: >= 1 and <= 250

Default value: 20

The size of the page.

filter[name] uuid

A valid SIM card group name.

filter[private_wireless_gateway_id] uuid

A Private Wireless Gateway ID associated with the group.

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object[]

Array [

id uuid

Identifies the resource.

record_type string

Identifies the type of the resource.

default boolean

Indicates whether the SIM card group is the users default group.
The default group is created for the user and can not be removed.

name string

A user friendly name for the SIM card group.

data_limit

object

Upper limit on the amount of data the SIM cards, within the group, can use.

amount decimal

unit string

Upper limit on the amount of data the SIM cards, within the group, can use.

consumed_data

object

Represents the amount of data consumed.

unit string

Default value: MB

amount decimal

Represents the amount of data consumed.

sim_card_count integer

Default value: 0

The number of SIM cards associated with the group.

private_wireless_gateway_id uuid

The identification of the related Private Wireless Gateway resource.

created_at string

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

updated_at string

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

]

meta

object

total_pages integer

total_results integer

page_number integer

page_size integer

{
  "data": [
    {
      "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "record_type": "sim_card_group",
      "default": true,
      "name": "My Test Group",
      "data_limit": {
        "amount": "2048.1",
        "unit": "MB"
      },
      "consumed_data": {
        "unit": "MB",
        "amount": "2048.1"
      },
      "sim_card_count": 10,
      "private_wireless_gateway_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "created_at": "2018-02-02T22:25:27.521Z",
      "updated_at": "2018-02-02T22:25:27.521Z"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

401: Unauthorized

default: Unexpected error

application/json

• Schema
• Example (from schema)

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

]

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/sim_card_groups' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• default

---

{
  "data": [
    {
      "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "record_type": "sim_card_group",
      "default": true,
      "name": "My Test Group",
      "data_limit": {
        "amount": "2048.1",
        "unit": "MB"
      },
      "consumed_data": {
        "unit": "MB",
        "amount": "2048.1"
      },
      "sim_card_count": 10,
      "private_wireless_gateway_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "created_at": "2018-02-02T22:25:27.521Z",
      "updated_at": "2018-02-02T22:25:27.521Z"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}