Get Sender ID Verifications#

Returns the collection of Sender ID verifications of the account.

Request#

HTTP Method: GET

URI Path: /v3/sender_id_verifications

Note

For all returned data attributes, see Sender ID Verification Object.

URI Query Parameters#

Name

Type

Is Required?

Description

include

string

No

Inclusion

filter[<filter_name>]

string

No

Filtering

fields[sender_id_verifications]

string

No

Sparse fieldsets

sort

string

No

Sorting

page[number]

integer

No

Page number.

page[size]

integer

No

Page size. Pagination defaults to 50 records per page. The maximum is 100.

Includes#

Value

Description

sms_trunk

SMS Trunk Object

countries

Country Object

dids

DID Object

order

Order Object

identity

Identity Object

address

Addresses Object

Filters#

Filter Name

Type

Allow Blank

Allow Array

Filters by:

id

string

No

Yes

The verification id field.

name

string

No

No

Verifications whose name field contains this value.

reference

string

No

No

The reference field (exact match).

status

string

No

No

The status field. Possible values: active, changes_required, closed, closing_in_process, in_process, new.

sender_type

string

No

No

The sender_type field. Possible values: alphanumeric, carrier, long_code, short_code, toll_free.

sms_trunk.id

string

No

Yes

The ID field of sms_trunk relationship.

Sorting#

Value

Sorts by:

name

The name field.

status

The status field.

created_at

The created_at field.

renew_date

The renew_date field.

Prefix a value with - to sort in descending order.

Examples#

http

1GET /v3/sender_id_verifications HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X GET https://api.didww.com/v3/sender_id_verifications -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5  "data": [
  6    {
  7      "id": "e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10",
  8      "type": "sender_id_verifications",
  9      "attributes": {
 10        "name": "ACME alerts",
 11        "status": "active",
 12        "sender_type": "alphanumeric",
 13        "sender_ids": [
 14          "ACME"
 15        ],
 16        "reference": "SID-1234",
 17        "reject_reasons": null,
 18        "reject_comment": null,
 19        "renew_date": "2026-11-22",
 20        "created_at": "2026-10-22T09:15:42.118Z",
 21        "activated_at": "2026-10-22T11:40:03.512Z",
 22        "closed_at": null
 23      },
 24      "relationships": {
 25        "sms_trunk": {
 26          "links": {
 27            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/sms_trunk",
 28            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/sms_trunk"
 29          }
 30        },
 31        "countries": {
 32          "links": {
 33            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
 34            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
 35          }
 36        },
 37        "dids": {
 38          "links": {
 39            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
 40            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
 41          }
 42        },
 43        "order": {
 44          "links": {
 45            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
 46            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
 47          }
 48        },
 49        "identity": {
 50          "links": {
 51            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
 52            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
 53          }
 54        },
 55        "address": {
 56          "links": {
 57            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
 58            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
 59          }
 60        }
 61      },
 62      "meta": {
 63        "setup_price": "10.0",
 64        "monthly_price": "15.0"
 65      }
 66    },
 67    {
 68      "id": "f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58",
 69      "type": "sender_id_verifications",
 70      "attributes": {
 71        "name": "Support replies",
 72        "status": "changes_required",
 73        "sender_type": "long_code",
 74        "sender_ids": [
 75          "12025550123"
 76        ],
 77        "reference": "SID-1235",
 78        "reject_reasons": [
 79          "Verification outdated"
 80        ],
 81        "reject_comment": "Update the address.",
 82        "renew_date": "2026-11-22",
 83        "created_at": "2026-10-22T09:20:11.904Z",
 84        "activated_at": null,
 85        "closed_at": null
 86      },
 87      "relationships": {
 88        "sms_trunk": {
 89          "links": {
 90            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/sms_trunk",
 91            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/sms_trunk"
 92          }
 93        },
 94        "countries": {
 95          "links": {
 96            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/countries",
 97            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/countries"
 98          }
 99        },
100        "dids": {
101          "links": {
102            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/dids",
103            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/dids"
104          }
105        },
106        "order": {
107          "links": {
108            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/order",
109            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/order"
110          }
111        },
112        "identity": {
113          "links": {
114            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/identity",
115            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/identity"
116          }
117        },
118        "address": {
119          "links": {
120            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/address",
121            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/address"
122          }
123        }
124      },
125      "meta": {
126        "setup_price": "5.5",
127        "monthly_price": "2.25"
128      }
129    }
130  ],
131  "meta": {
132    "api_version": "2026-11-19",
133    "total_records": 2
134  },
135  "links": {
136    "first": "https://api.didww.com/v3/sender_id_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
137    "last": "https://api.didww.com/v3/sender_id_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
138  }
139}

Other Responses#

Code

Success

Description

400

No

Bad Request

401

No

Unauthorized

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.