WAwafeq
Device

List

Changed on

Endpoint for retrieving a list of Devices.

get/zatca/devices/

Request

  • Base URL
    https://api.wafeq.com/v1
  • URL
    https://api.wafeq.com/v1/zatca/devices/
  • Auth
    API key in header Authorization

Query parameters

keywordstring

The search term, based on fields:

  • common_name - The common name of the device (contains, case-insensitive).
pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Headers

X-ZATCA-Branchstring

If the account is under a Group VAT, then it is required to be the TIN of the instance under the Group VAT. Otherwise it is optional and can be used as a branch name

X-ZATCA-Connected-Account-Idstring

The unique identifier of the connected account you're operating on behalf of.

Connected accounts should be used only for Platforms and White Label integrations that onboard customers and report documents on their behalf. Omit the X-ZATCA-Connected-Account-Id header when registering devices or reporting documents for your own organization. See the Platforms and White Label guide.

X-ZATCA-Environmentstring

The ZATCA environment to use, one of ['production', 'simulation']. A ZATCA API key (starting with zatca_live_ or zatca_sim_) already names its environment, so the header is optional with it and must match it when sent. Other API keys and OAuth tokens need it.

Response

countinteger required

The total number of results across all pages.

nextstring uri nullable

The URL of the next page of results, or null on the last page.

previousstring uri nullable

The URL of the previous page of results, or null on the first page.

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}

Changes

  • 6b4a622bbb4fRevision changes
    • info

      added the new optional query request parameter keyword

    • info

      the header request parameter X-ZATCA-Environment became optional

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status