---
title: "Get Services and APIs"
method: GET
path: "/services"
tags: ["mock"]
---

# Get Services and APIs

`GET /services`

## Query parameters

- `page` integer
- `size` integer

## Response `200`

List of found Services

- Service — Represents a Service or API definition as registred into Microcks repository
  - `id` string — Unique identifier for this Service or API
  - `name` string, required — Distinct name for this Service or API (maybe shared among many versions)
  - `version` string, required — Distinct version for a named Service or API
  - `type` 'REST' | 'SOAP_HTTP' | 'GENERIC_REST' | 'GENERIC_EVENT' | 'EVENT' | 'GRPC' | 'GRAPHQL', required — Service or API Type
  - `operations` Operation[] — Set of Operations for Service or API
    - `name` string, required — Unique name of this Operation within Service scope
    - `method` string, required — Represents transport method
    - `inputName` string — Name of input parameters in case of Xml based Service
    - `outputName` string — Name of output parameters in case of Xml based Service
    - `dispatcher` string — Dispatcher strategy used for mocks
    - `dispatcherRules` string — DispatcherRules used for mocks
    - `defaultDelay` number — Default response time delay for mocks
    - `resourcePaths` string[] — Paths the mocks endpoints are mapped on
    - `parameterContraints` ParameterConstraint[] — Contraints that may apply to mock invocatino on this operation
      - `name` string, required — Parameter name
      - `required` boolean — Whether it's a required constraint
      - `recopy` boolean — Whether it's a recopy constraint
      - `mustMatchRegexp` string — Whether it's a regular expression matching constraint
      - `in` 'path' | 'query' | 'header' — Parameter location
    - `bindings` object — Map of protocol binding details for this operation
  - `xmlNS` string — Associated Xml Namespace in case of Xml based Service
  - `metadata` Metadata — Commodity object for holding metadata on any entity. This object is inspired by Kubernetes metadata.
    - `createdOn` integer, required — Creation date of attached object
    - `lastUpdate` integer, required — Last update of attached object
    - `annotations` object — Annotations of attached object
    - `labels` object — Labels put on attached object

---

[API](https://skmtc.dev/microcks/apis/microcks-api-v1-7.md) · [All operations](https://skmtc.dev/microcks/apis/microcks-api-v1-7/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microcks/microcks-api-v1-7/revisions/cc062ec25192/schema)