# List all services of a project

Retrieve a list of voice services in the specified project.
Optionally:
- Filter services by partial match on name or description (
`filter`
)
- Return only the default service (
`default=true`
)

Endpoint: GET /v2/projects/{projectId}/services
Version: 2.0.59
Security: BasicAuth, SinchOAuth2

## Security:

  - `BasicAuth` (unknown)
    http basic

  - `SinchOAuth2` (unknown)
    oauth2

## Path parameters:

  - `projectId` (string, required)
    The ID of the project.

## Query parameters:

  - `filter` (string)
    Filter services by name or description.  Returns all services where either the name or description contains the specified value (case-insensitive partial match).

  - `isDefault` (boolean)
    Return the default service only.

  - `pageSize` (integer)
    Number of items to be returned on each page.

  - `page` (integer)
    Page number (1-based)

## Response 200:

  - `200` (unknown)
    A list of services.

## Response 200 fields (application/json):

  - `services` (array, required)

  - `services.serviceId` (string, required)
    The ID of the service used.

  - `services.projectId` (string, required)
    The `Id` of the project associated with the call.

  - `services.createTime` (string, required)
    Timestamp (RFC 3339) indicating when the service was created.
    Example: 2025-01-01 00:00:00+00:00

  - `services.updateTime` (string)
    Timestamp (RFC 3339) indicating when the service was last updated.

Omitted if no updates were performed on this service.
    Example: 2025-01-01 00:00:00+00:00

  - `services.name` (string, required)
    Name of the service
    Example: My Voice Service

  - `services.description` (string)
    Description of the service
    Example: My Voice Service Description

  - `services.isDefault` (boolean, required)
    Indicates whether this service is set as the default for the project.
The default service is used when no specific service is specified in API requests.
    Example: true

  - `links` (object, required)
    Pagination links for navigating through pages of results in a paginated list response.
Available link properties:
- `first`
 - Absolute URI of the first page
- `last`
 - Absolute URI of the last page
- `next`
 - Absolute URI of the next page (omitted if this is the last page)
- `prev`
 - Absolute URI of the previous page (omitted if this is the first page)
- `self`
 - Absolute URI of the current page

  - `links.first` (string, required)
    Absolute URI of the first page.
    Example: https://voice.api.sinch.com/v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls?page=1&pageSize=20

  - `links.last` (string, required)
    Absolute URI of the last page.
    Example: https://voice.api.sinch.com/v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls?page=5&pageSize=20

  - `links.next` (string)
    Absolute URI of the next page (omitted if this is the last page).
    Example: https://voice.api.sinch.com/v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls?page=3&pageSize=20

  - `links.prev` (string)
    Absolute URI of the previous page (omitted if this is the first page).
    Example: https://voice.api.sinch.com/v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls?page=1&pageSize=20

  - `links.self` (string, required)
    Absolute URI of the current page.
    Example: https://voice.api.sinch.com/v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls?page=2&pageSize=20

  - `meta` (object, required)
    Metadata about the paginated list response.

  - `meta.totalCount` (integer, required)
    Total number of items across all pages.
    Example: 100

  - `meta.pageCount` (integer, required)
    Total number of pages.
    Example: 5

## Response 400:

  - `400` (unknown)
    Invalid request parameters.

## Response 400 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/bad-request"

  - `title` (any, required)
    Enum: "Bad Request"

  - `detail` (any, required)
    Example: The request body is invalid or malformed.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 401:

  - `401` (unknown)
    Authentication failed — token missing, invalid, or expired.

## Response 401 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/unauthorized"

  - `title` (any, required)
    Enum: "Unauthorized"

  - `detail` (any, required)
    Example: The token is missing, invalid, or has expired.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 401 headers (application/problem+json):

  - `WWW-Authenticate` (string)
    RFC 7235 challenge. Indicates the required authentication scheme and, for expired tokens, provides an error hint.
    Example: Bearer realm="sinch", error="invalid_token", error_description="Token has expired"

## Response 403:

  - `403` (unknown)
    Forbidden.

## Response 403 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/forbidden"

  - `title` (any, required)
    Enum: "Forbidden"

  - `detail` (any, required)
    Example: The request was rejected.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 404:

  - `404` (unknown)
    Resource not found.

## Response 404 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/not-found"

  - `title` (any, required)
    Enum: "Not Found"

  - `detail` (any, required)
    Example: The requested resource was not found.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 429:

  - `429` (unknown)
    Too many requests — rate limit exceeded.

## Response 429 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/too-many-requests"

  - `title` (any, required)
    Enum: "Too Many Requests"

  - `detail` (any, required)
    Example: Rate limit exceeded. Please slow down your request rate and retry after the indicated period.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls

## Response 429 headers (application/problem+json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying the request.
    Example: 60

## Response 500:

  - `500` (unknown)
    Internal server error occurred.

## Response 500 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/internal-server-error"

  - `title` (any, required)
    Enum: "Internal Server Error"

  - `detail` (any, required)
    Example: An unexpected error occurred on the server.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

