---
title: "Search request services"
method: GET
path: "/v1/RequestServices"
tags: ["RequestServices"]
---

# Search request services

`GET /v1/RequestServices`

Search for one or more request services.

## Query parameters

- `search.request_service_id` integer[]
- `search.request_id` integer[]
- `search.request_address_id` integer[]
- `search.created_date_start` string, date-time
- `search.created_date_end` string, date-time
- `search.number` string[]
- `search.number2` string[]
- `search.provider_account_number` string[]
- `search.page_size` integer
- `search.page` integer
- `search.sort` string

## Response `200`

OK

- RevWebAPIModelsGetOrSearchOfRevAppSearchModelsResponseOfRevAppModelsRequestService
  - `ok` boolean
  - `has_more` boolean — Helper for pagination. Indicates there are more records returned.
  - `record_count` integer — Total number of records found by the search.
  - `records` RevAppModelsRequestService[] — List of records returned.
    - `request_service_id` integer — Primary identifier for this request service.
    - `request_address_id` integer, required — Foreign identifier indicating address service is delivered to, if different from account.
    - `request_addressz_id` integer — Foreign identifier indicating address of opposite end of a connection (as with a point to point).
    - `request_id` integer, required — Foreign identifier indicating which request this is on.
    - `service_type_id` integer, required — Foreign identifier indicating the type of service delivered.
    - `provider_id` integer, required — Foreign identifier indicating the underlying provider of service.
    - `provider_account_id` integer — Foreign identifier indicating which account, on the provider's system, to use.
    - `usage_plan_group_id` integer — Foreign identifier indicating a group of rating rules to apply to usage.
    - `package_id` integer — Foreign identifier indicating the package of products applied to the service.
    - `number` string — An identifier for the service, provider-side (i.e. TN, IP, Account ID).
    - `number2` string — A network-level identifier, provider-side (i.e. Circuit ID).
    - `provider_account_number` string — Secondary identifier for the service, provider-side.
    - `description` string — Short description of the service.
    - `created_date` string, date-time — Date and time this service was added to the request.
    - `created_by` integer — Foreign identifier indicating which user added the service to the request.
    - `contract_start` string, date-time — Date service contract starts.
    - `contract_end` string, date-time — Date service contract ends.
    - `pic` string — Primary Interexchange Carrier code - indicates long distance service provider.
    - `lpic` string — Local Primary Interexchange Carrier code - indicates local service provider.
    - `order_type` 'NOT_SPECIFIED' | 'ADD_LINE' | 'CHANGE_FEATURE' | 'CHANGE_LISTING' | 'CHANGE_TN' | 'CONVERSION' | 'DENY' | 'DISCONNECT' | 'LD_BLOCK' | 'LD_RESTORE' | 'MIGRATION' | 'MIGRATION_UNEL' | 'NEW' | 'PORT' | 'REFRESH' | 'RESTORE' | 'SUSPEND' | 'TRANSFER' | 'CNAM' | 'E911' | 'FIBER_CONVERSION' — Indicates whether a New or Conversion order should be produced for this service. Allowed Values: NEW, CONVERSION
    - `fields` RevAppModelsFieldValue[] — List of custom fields and their values.
      - `field_id` integer — Primary identifier for this custom field.
      - `label` string — User-defined identifier representing the custom field.
      - `value` string — Value of the custom field.
      - `links` RevAppComponentsLink[]
        - `rel` string
        - `href` string
    - `links` RevAppComponentsLink[]
      - `rel` string
      - `href` string

## Other responses

- `500` — InternalServerError

---

[API](https://skmtc.net/rev-io/apis/rev-io-api.md) · [All operations](https://skmtc.net/rev-io/apis/rev-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rev-io/rev-io-api/revisions/135571434f6c/schema)