---
title: "Get Service"
method: GET
path: "/services/{id}"
tags: ["mock"]
---

# Get Service

`GET /services/{id}`

## Query parameters

- `messages` boolean

## Response `200`

- union
  - 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
  - ServiceView — Aggregate bean for grouping a Service an its messages pairs
    - `service` Service, required — 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
    - `messagesMap` object, required — Map of messages for this Service. Keys are operation name, values are array of messages for this operation

---

[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)