---
title: "Get resource requests"
method: GET
path: "/resources/1/requests"
tags: ["platform", "resources", "resource-request"]
---

# Get resource requests

`GET /resources/1/requests`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/resources/1/requests`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Gets a page of resource requests, using query parameters to filter results.

## Query parameters

- `id` string[]
- `countryCode` string[]
- `status` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceOrderStatus[]
- `type` string[]
- `senderNameLike` string
- `applicationId` string[]
- `entityId` string[]
- `page` integer
- `size` integer
- `sort` string[]

## Response `200`

OK

- C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPageResourceOrderApiDoc
  - `results` union[]: The list of the results for this page.
    - union: The list of the results for this page.
      - object
        - `id` string, uuid: The ID of the resource.
        - `type` 'ALPHANUMERIC_REGISTRATION': Type of resource.
        - `countryCode` string: Country code in two-letter ISO standard.
        - `senderName` string: Sender name.
        - `requestedByEmailAddress` string: Email address of the requester.
        - `additionalContactEmailAddresses` string[]: Additional email addresses.
        - `requestedDate` string, date-time: Date and time the resource was requested.
        - `status` 'PENDING' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'CANCELED' | 'AUTOMATIC_VALIDATION' | 'UPDATE_REQUESTED' | 'REJECTED' | 'COMPLETED' | 'PENDING_REVIEW' | 'IN_REVIEW' | 'IN_PROGRESS' | 'EXPIRED': Live resource request status at query time.
        - `trafficOrigin` 'LOCAL' | 'INTERNATIONAL': The location from which outbound messages are sent, relative to the country associated with the sender. - LOCAL: Indicates that the business sending the messages is headquartered in the same country as the sender being launched. - INTERNATIONAL: Indicates that the business is headquartered outside the country associated with the sender being launched.
        - `trafficType` 'PROMOTIONAL' | 'TRANSACTIONAL': Type of SMS messages you will send. - TRANSACTIONAL: Messages triggered by user actions or system events, such as one-time passwords (OTP/PIN), transaction alerts, password resets, or service notifications. - PROMOTIONAL: Messages sent for marketing or advertising purposes, such as promotions, offers, campaigns, or announcements.
        - `note` string: A note containing extra data about the request.
        - `requirementsFeedback` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirementFeedback[]: List of feedback for requirements. Deprecated only when the `structuredFeedback` feature opt-in is enabled.
          - `key` string: Key of the requirement for which feedback is provided.
          - `code` 'RES_REQ_FEED_REQUIRED' | 'RES_REQ_FEED_FORMAT' | 'RES_REQ_FEED_LENGTH_OOR' | 'RES_REQ_FEED_VALUE_OOR' | 'RES_REQ_FEED_OTHER': Code of the feedback.
          - `feedback` string: Feedback for the requirement.
        - `feedback` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfAlphaResourceOrderFeedbackApiDoc[]: List of standardized and structured feedback for the resource order. Provided only when the `structuredFeedback` feature opt-in is enabled.
          - `requirementKey` string: Key of the requirement the feedback refers to.
          - `errors` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceOrderFeedbackError[]: List of validation errors for the requirement.
            - `key` string: Code identifying the type of error.
            - `reason` string: Reason for the error.
            - `details` string: Additional details and recommended actions for the error.
        - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[]: List of requirements for the resource.
          - `key` string, required: The key of the requirement.
          - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
        - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
          - `applicationId` string: ID of the Application that would be associated with the resource request.
          - `entityId` string: ID of the Entity that would be associated with the resource request.
      - object
        - `id` string, uuid: The ID of the resource.
        - `type` 'NUMBER_PURCHASE': Type of resource.
        - `countryCode` string: Country code in two-letter ISO standard.
        - `requestedByEmailAddress` string: Email address of the requester.
        - `additionalContactEmailAddresses` string[]: Additional email addresses.
        - `requestedDate` string, date-time: Date and time the resource was requested.
        - `status` 'PENDING' | 'AUTOMATIC_VALIDATION' | 'UPDATE_REQUESTED' | 'PENDING_REVIEW' | 'IN_REVIEW' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'IN_PROGRESS' | 'COMPLETED' | 'REJECTED' | 'CANCELED': Current status of the resource request.
        - `numberType` 'SHORT_CODE' | 'VIRTUAL_LONG_NUMBER' | 'TEN_DIGIT_LONG_CODE' | 'TOLL_FREE_NUMBER': Type of numbers.
        - `capabilities` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceNumberCapability[]: Capabilities of the numbers.
        - `quantity` integer: Amount of numbers.
        - `note` string: A note containing extra data about the request.
        - `numbers` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfProcuredNumber[]: List of numbers linked with the resource.
          - `number` string, required: Number.
          - `numberKey` string: Unique ID of a number.
          - `status` 'SUCCESS', required: Status of the number.
        - `requirementsFeedback` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirementFeedback[]: List of feedback for requirements.
          - `key` string: Key of the requirement for which feedback is provided.
          - `code` 'RES_REQ_FEED_REQUIRED' | 'RES_REQ_FEED_FORMAT' | 'RES_REQ_FEED_LENGTH_OOR' | 'RES_REQ_FEED_VALUE_OOR' | 'RES_REQ_FEED_OTHER': Code of the feedback.
          - `feedback` string: Feedback for the requirement.
        - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[]: List of requirements for the resource.
          - `key` string, required: The key of the requirement.
          - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
        - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
          - `applicationId` string: ID of the Application that would be associated with the resource request.
          - `entityId` string: ID of the Entity that would be associated with the resource request.
      - object
        - `id` string, uuid: The ID of the resource.
        - `type` 'RCS_SENDER_LAUNCH': Type of resource.
        - `status` 'PENDING' | 'UPDATE_REQUESTED_BY_INTERNAL_REVIEWER' | 'CANCELED' | 'AUTOMATIC_VALIDATION' | 'UPDATE_REQUESTED' | 'REJECTED' | 'COMPLETED' | 'PENDING_REVIEW' | 'IN_REVIEW' | 'IN_PROGRESS' | 'EXPIRED': Live resource request status at query time.
        - `countryCode` string: Country code in two-letter ISO standard.
        - `excludedCarriers` string[]: List of carrier names excluded from the sender launch.
        - `senderName` string: Sender name.
        - `requestedByEmailAddress` string: Email address of the requester.
        - `additionalContactEmails` string[]: Additional email addresses.
        - `requestedDate` string, date-time: Date and time the resource was requested.
        - `trafficOrigin` 'LOCAL' | 'INTERNATIONAL': The location from which outbound messages are sent, relative to the country associated with the sender. - LOCAL: Indicates that the business sending the messages is headquartered in the same country as the sender being launched. - INTERNATIONAL: Indicates that the business is headquartered outside the country associated with the sender being launched.
        - `note` string: A note containing extra data about the request.
        - `requirements` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirement[]: List of requirements for the resource.
          - `key` string, required: The key of the requirement.
          - `value` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfJsonNode, required: The value of the requirement. Can be a string, integer, or a list of strings and integers.
        - `requirementsFeedback` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfFilledRequirementFeedback[]: List of feedback for requirements. Deprecated only when the `structuredFeedback` feature opt-in is enabled.
          - `key` string: Key of the requirement for which feedback is provided.
          - `code` 'RES_REQ_FEED_REQUIRED' | 'RES_REQ_FEED_FORMAT' | 'RES_REQ_FEED_LENGTH_OOR' | 'RES_REQ_FEED_VALUE_OOR' | 'RES_REQ_FEED_OTHER': Code of the feedback.
          - `feedback` string: Feedback for the requirement.
        - `feedback` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfRcsSenderResourceOrderFeedbackApiDoc[]: List of standardized and structured feedback for the resource order. Provided only when the `structuredFeedback` feature opt-in is enabled.
          - `requirementKey` string: Key of the requirement the feedback refers to.
          - `externalRequirementKey` string: External key of the requirement the feedback refers to, referring to an RCS sender launch request property. Examples: `bannerUrl` (top-level property), `termsOfService.url` (nested property), `phones[0].phoneNumber` (property of an array item). See [Get RCS sender](/docs/api/channels/rcs/rcs-service-management/rcs-sender-management/get-rcs-sender).
          - `errors` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfResourceOrderFeedbackError[]: List of validation errors for the requirement.
            - `key` string: Code identifying the type of error.
            - `reason` string: Reason for the error.
            - `details` string: Additional details and recommended actions for the error.
        - `platform` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPlatform: CPaaS X properties.
          - `applicationId` string: ID of the Application that would be associated with the resource request.
          - `entityId` string: ID of the Entity that would be associated with the resource request.
  - `paging` C8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcfPageInfo: Page information. totalResults counts distinct matching values.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)
