Get Sender ID Verification#
Returns a single Sender ID verification of the account.
Request#
HTTP Method: GET
URI Path: /v3/sender_id_verifications/{id}
Note
For all returned data attributes, see Sender ID Verification Object.
URI Query Parameters#
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
id |
|
Yes |
Unique identifier of the Sender ID verification. |
include |
|
No |
|
fields[sender_id_verifications] |
|
No |
Includes#
Value |
Description |
|---|---|
sms_trunk |
|
countries |
|
dids |
|
order |
|
identity |
|
address |
Examples#
http
1GET /v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10 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/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10 -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 "id": "e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10",
7 "type": "sender_id_verifications",
8 "attributes": {
9 "name": "ACME alerts",
10 "status": "active",
11 "sender_type": "alphanumeric",
12 "sender_ids": [
13 "ACME"
14 ],
15 "reference": "SID-1234",
16 "reject_reasons": null,
17 "reject_comment": null,
18 "renew_date": "2026-11-22",
19 "created_at": "2026-10-22T09:15:42.118Z",
20 "activated_at": "2026-10-22T11:40:03.512Z",
21 "closed_at": null
22 },
23 "relationships": {
24 "sms_trunk": {
25 "links": {
26 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/sms_trunk",
27 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/sms_trunk"
28 }
29 },
30 "countries": {
31 "links": {
32 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
33 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
34 }
35 },
36 "dids": {
37 "links": {
38 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
39 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
40 }
41 },
42 "order": {
43 "links": {
44 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
45 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
46 }
47 },
48 "identity": {
49 "links": {
50 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
51 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
52 }
53 },
54 "address": {
55 "links": {
56 "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
57 "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
58 }
59 }
60 },
61 "meta": {
62 "setup_price": "10.0",
63 "monthly_price": "15.0"
64 }
65 },
66 "meta": {
67 "api_version": "2026-11-19"
68 }
69}
http
1GET /v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58?include=dids 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/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58?include=dids' -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 "id": "f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58",
7 "type": "sender_id_verifications",
8 "attributes": {
9 "name": "Support replies",
10 "status": "changes_required",
11 "sender_type": "long_code",
12 "sender_ids": [
13 "12025550123"
14 ],
15 "reference": "SID-1235",
16 "reject_reasons": [
17 "Verification outdated"
18 ],
19 "reject_comment": "Update the address.",
20 "renew_date": "2026-11-22",
21 "created_at": "2026-10-22T09:20:11.904Z",
22 "activated_at": null,
23 "closed_at": null
24 },
25 "relationships": {
26 "sms_trunk": {
27 "links": {
28 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/sms_trunk",
29 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/sms_trunk"
30 }
31 },
32 "countries": {
33 "links": {
34 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/countries",
35 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/countries"
36 }
37 },
38 "dids": {
39 "links": {
40 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/dids",
41 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/dids"
42 },
43 "data": [
44 {
45 "type": "dids",
46 "id": "2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d"
47 }
48 ]
49 },
50 "order": {
51 "links": {
52 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/order",
53 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/order"
54 }
55 },
56 "identity": {
57 "links": {
58 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/identity",
59 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/identity"
60 }
61 },
62 "address": {
63 "links": {
64 "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/address",
65 "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/address"
66 }
67 }
68 },
69 "meta": {
70 "setup_price": "5.5",
71 "monthly_price": "2.25"
72 }
73 },
74 "included": [
75 {
76 "id": "2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d",
77 "type": "dids",
78 "attributes": {
79 "blocked": false,
80 "capacity_limit": 1,
81 "description": "Support line",
82 "terminated": false,
83 "awaiting_registration": false,
84 "number": "12025550123",
85 "expires_at": "2026-11-22T09:15:42.118Z",
86 "channels_included_count": 2,
87 "created_at": "2026-10-01T08:21:41.795Z",
88 "dedicated_channels_count": 0,
89 "billing_cycles_count": null,
90 "emergency_enabled": false
91 },
92 "relationships": {
93 "did_group": {
94 "links": {
95 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/did_group",
96 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/did_group"
97 }
98 },
99 "order": {
100 "links": {
101 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/order",
102 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/order"
103 }
104 },
105 "capacity_pool": {
106 "links": {
107 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/capacity_pool",
108 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/capacity_pool"
109 }
110 },
111 "shared_capacity_group": {
112 "links": {
113 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/shared_capacity_group",
114 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/shared_capacity_group"
115 }
116 },
117 "address_verification": {
118 "links": {
119 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/address_verification",
120 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/address_verification"
121 }
122 },
123 "voice_in_trunk": {
124 "links": {
125 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/voice_in_trunk",
126 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/voice_in_trunk"
127 }
128 },
129 "voice_in_trunk_group": {
130 "links": {
131 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/voice_in_trunk_group",
132 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/voice_in_trunk_group"
133 }
134 },
135 "sms_trunk": {
136 "links": {
137 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/sms_trunk",
138 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/sms_trunk"
139 }
140 },
141 "sms_trunk_group": {
142 "links": {
143 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/sms_trunk_group",
144 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/sms_trunk_group"
145 }
146 },
147 "emergency_calling_service": {
148 "links": {
149 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/emergency_calling_service",
150 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/emergency_calling_service"
151 }
152 },
153 "emergency_verification": {
154 "links": {
155 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/emergency_verification",
156 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/emergency_verification"
157 }
158 },
159 "identity": {
160 "links": {
161 "self": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/relationships/identity",
162 "related": "https://api.didww.com/v3/dids/2b1f91d7-8f7a-4933-b1e4-43bbe6aff89d/identity"
163 }
164 }
165 }
166 }
167 ],
168 "meta": {
169 "api_version": "2026-11-19"
170 }
171}
Other Responses#
Code |
Success |
Description |
|---|---|---|
404 |
No |
|
401 |
No |
|
429 |
No |
The request budget of the account for the current window is spent ( |