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 |
|
No |
|
filter[<filter_name>] |
|
No |
|
fields[sender_id_verifications] |
|
No |
|
sort |
|
No |
|
page[number] |
|
No |
|
page[size] |
|
No |
Page size. Pagination defaults to |
Includes#
Value |
Description |
|---|---|
sms_trunk |
|
countries |
|
dids |
|
order |
|
identity |
|
address |
Filters#
Filter Name |
Type |
Allow Blank |
Allow Array |
Filters by: |
|---|---|---|---|---|
id |
|
No |
Yes |
The verification |
name |
|
No |
No |
Verifications whose |
reference |
|
No |
No |
The |
status |
|
No |
No |
The |
sender_type |
|
No |
No |
The |
sms_trunk.id |
|
No |
Yes |
The ID field of |
Sorting#
Value |
Sorts by: |
|---|---|
name |
The |
status |
The |
created_at |
The |
renew_date |
The |
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}
http
1GET /v3/sender_id_verifications?filter%5Bstatus%5D=active&filter%5Bsender_type%5D=alphanumeric&sort=-created_at 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?filter%5Bstatus%5D=active&filter%5Bsender_type%5D=alphanumeric&sort=-created_at' -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 "meta": {
69 "api_version": "2026-11-19",
70 "total_records": 1
71 },
72 "links": {
73 "first": "https://api.didww.com/v3/sender_id_verifications?filter%5Bsender_type%5D=alphanumeric&filter%5Bstatus%5D=active&sort=-created_at&page%5Bnumber%5D=1&page%5Bsize%5D=50",
74 "last": "https://api.didww.com/v3/sender_id_verifications?filter%5Bsender_type%5D=alphanumeric&filter%5Bstatus%5D=active&sort=-created_at&page%5Bnumber%5D=1&page%5Bsize%5D=50"
75 }
76}
http
1GET /v3/sender_id_verifications?include=sms_trunk 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?include=sms_trunk' -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 "data": {
31 "type": "sms_trunks",
32 "id": "6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13"
33 }
34 },
35 "countries": {
36 "links": {
37 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
38 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
39 }
40 },
41 "dids": {
42 "links": {
43 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
44 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
45 }
46 },
47 "order": {
48 "links": {
49 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
50 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
51 }
52 },
53 "identity": {
54 "links": {
55 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
56 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
57 }
58 },
59 "address": {
60 "links": {
61 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
62 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
63 }
64 }
65 },
66 "meta": {
67 "setup_price": "10.0",
68 "monthly_price": "15.0"
69 }
70 }
71 ],
72 "included": [
73 {
74 "id": "6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13",
75 "type": "sms_trunks",
76 "attributes": {
77 "name": "Outbound HTTP",
78 "external_reference_id": null,
79 "blocked": false,
80 "priority": null,
81 "allow_any_did_as_source": false,
82 "allow_in": false,
83 "allow_out": true,
84 "created_at": "2026-10-22T09:15:42.118Z",
85 "updated_at": "2026-10-22T09:15:42.118Z",
86 "configuration": {
87 "type": "http_out",
88 "attributes": {
89 "callback_url": "https://example.com/sms/status",
90 "allowed_ips": [
91 "203.0.113.10/32"
92 ],
93 "auth_name": "k3v9xq2m7p",
94 "auth_password": "w8r2c5n1zt"
95 }
96 }
97 },
98 "relationships": {
99 "outgoing_dids": {
100 "links": {
101 "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/outgoing_dids",
102 "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/outgoing_dids"
103 }
104 },
105 "incoming_dids": {
106 "links": {
107 "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/incoming_dids",
108 "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/incoming_dids"
109 }
110 },
111 "sms_trunk_group": {
112 "links": {
113 "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sms_trunk_group",
114 "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sms_trunk_group"
115 }
116 },
117 "sender_id_verifications": {
118 "links": {
119 "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sender_id_verifications",
120 "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sender_id_verifications"
121 }
122 }
123 },
124 "meta": {
125 "host": "https://us.sms-out.didww.com/outbound_messages"
126 }
127 }
128 ],
129 "meta": {
130 "api_version": "2026-11-19",
131 "total_records": 1
132 },
133 "links": {
134 "first": "https://api.didww.com/v3/sender_id_verifications?include=sms_trunk&page%5Bnumber%5D=1&page%5Bsize%5D=50",
135 "last": "https://api.didww.com/v3/sender_id_verifications?include=sms_trunk&page%5Bnumber%5D=1&page%5Bsize%5D=50"
136 }
137}
Other Responses#
Code |
Success |
Description |
|---|---|---|
400 |
No |
|
401 |
No |
|
429 |
No |
The request budget of the account for the current window is spent ( |