Get resource association

Get an exact resource association.

Please log in to see full path URL. Learn why.
get
/provisioning/1/associations/single
Request rate limit:
1 requests / second (per account)
query Parameters
resourceType
required
string
Enum: "NUMBER" "DOMAIN" "ALPHA"

The type of resource to be used.

channel
required
string
Enum: "SMS" "MMS" "EMAIL"

The channel for which the resource will be used.

applicationId
required
string <= 255 characters
Example: applicationId=test-application

The unique identifier of the application. This ID will be a URL path parameter. We recommend using values that do not need URL encoding for easier interaction with other API endpoints.

entityId
string <= 255 characters
Example: entityId=test-entity

The unique identifier of the entity. This ID will be a URL path parameter. We recommend using values that do not need URL encoding for easier interaction with other API endpoints. If no entity is associated with this resource, set the entityId to null.

resourceId
required
string <= 255 characters
Example: resourceId=test-resource

The unique identifier of the resource. It depends on both the resourceType and channel.
Use numberKey for the NUMBER resourceType.
Use domainName for the DOMAIN resourceType, which is available only for the Email channel.

Responses

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

429

Too Many Requests

500

Internal Server Error

Request samples

Example
cURL
Copy
curl -L -g 'https://{baseUrl}/provisioning/1/associations/single?resourceType=%7BresourceType%7D&channel=%7Bchannel%7D&applicationId=test-application&entityId=test-entity&resourceId=test-resource' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type
application/json
Copy
Collapse all
{
  • "resourceType": "NUMBER",
  • "channel": "SMS",
  • "applicationId": "test-application",
  • "entityId": "test-entity",
  • "resourceId": "test-resource"
}

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.