Services

Search services

Changed on

Search for one or more services.

get/v1/Services

Request

Query parameters

search.service_idinteger[]

Query by service identifier. Required when filtering by active services only if no customer_id is provided.

search.customer_idinteger[]

Query by account identifier. Required when filtering by active services only if no service_id is provided.

search.provider_account_numberstring[]

Query by all or part of this text value.

search.numberstring[]

Query all or part of the number.

search.created_date_startstring date-time

Query by created date.

search.created_date_endstring date-time

Query by created date.

search.request_service_idinteger[]

Query by request service identifier.

search.number2string[]

Query all or part of the network-level identifier.

search.provider_idinteger[]

Query by provider primary identifier

search.service_type_idinteger[]

Query by the service type primary identifier

search.package_idinteger[]

Query by package primary identifier

search.provider_account_idinteger[]

Query provider account primary identifier

search.usage_plan_group_idinteger[]

Query by usage plan group primary identifier

search.descriptionstring[]

Query all or part of the description

search.disconnected_date_startstring date-time

Query by disconnected date

search.disconnected_date_endstring date-time

Query by disconnected date

search.activated_date_startstring date-time

Query by activated date

search.activated_date_endstring date-time

Query by activated date

search.address_idinteger[]

Query by address primary identifier

search.contract_startstring date-time

Query by contract date

search.contract_endstring date-time

Query by contract date

search.active_only_statusboolean

A filter to return only active services in the search results. Requires customer_id or service_id.

search.custom_field_namestring

Query by custom field display name (label). Must be paired with custom_field_value. Matching against the name is case-insensitive and ignores leading/trailing whitespace. Must currently match at least one active custom field defined for services, or the request fails with a clear error rather than silently returning no matches - this covers the case where a name that was previously relied on gets renamed or deactivated, as long as no other active field has since taken on that same name. If more than one active field shares this name, matches from all of them are included together.

search.custom_field_valuestring

The value to match against the custom field identified by custom_field_name. Must be paired with custom_field_name. Matching is exact (not partial), case-insensitive, and ignores leading/trailing whitespace. An empty value matches services where the field has an explicitly blank/empty value; services that never had a value set for this field at all are not matched.

search.page_sizeinteger

Defines how many items to return at a time.

search.pageinteger

Specifies which page to display (i.e. 3rd page of 50 items out of 1000 items)

search.sortstring

Specifies the model member you wish to sort by. Defaults to Ascending order, add a "-" sign to the beginning to indicate Descending order.

Response

OK

okboolean
has_moreboolean

Helper for pagination. Indicates there are more records returned.

record_countinteger

Total number of records found by the search.

Changes

    • info

      added the new optional query request parameter search.custom_field_name

    • info

      added the new optional query request parameter search.custom_field_value

    • info

      added the optional property // to the response with the status (media type: application/json)

    • info

      added the optional property // to the response with the status (media type: text/json)

    • info

      added the optional property // to the response with the status (media type: text/html)