BICS Emergency Services API

openapi: 3.0.1
info:
  title: connect Address Management Emergency Services API
  description: "The Cloud Connect Service is a comprehensive multi-cloud one-stop-shop solution that provides a unique combination of layer 2 transport, which is provided by BICS, and dedicated connectivity (hosted connection) directly to the Cloud Service Provider (CSP) infrastructure. This service bypasses the public internet, ensuring reliable, secure, and fast connectivity.\n\nWithin each Cloud Connect Service, the Ethernet Virtual Private Line (EVPL) is provisioned on BICS network defined by MEF 6.2. The EVPL is a secure, point-to-point Ethernet service that provides a high-performance, low-latency connection between your on-premises infrastructure and the CSP infrastructure. \n\nThank you for considering BICS Cloud Connect Service and using our API. If you have any questions or concerns, please contact BICS customer support."
  version: v1
servers:
- url: https://api.bics.com/connect/v1
tags:
- name: Emergency Services
  description: Manage your emergency services request
paths:
  /emergencyservices/requirements/{country}:
    parameters: []
    get:
      tags:
      - Emergency Services
      summary: Get list of extra requirement fields per country
      description: Every country has specific requirements for the activation of Emergency Services. This method will return a list of additional information. In the result, we specify some attributes, like type of attribute, min-length, max-length and if it is mandatory or optional.
      operationId: get Emergency Service Country Specific Fields
      parameters:
      - name: country
        in: path
        description: Country for country specific fields
        required: true
        allowEmptyValue: false
        schema:
          type: string
          description: Country for country specific fields
          readOnly: false
          example: FRA
      responses:
        '200':
          description: Country specific fields for France
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmergencyServiceCountryConfig'
              example: "{\n  'country': 'FRA',\n  'additionalInformation': [\n    {\n      'key': 'FRA3',\n      'label': 'Building',\n      'type': 'select',\n      'attributes': [\n        {\n          'key': 'required',\n          'value': 'true'\n        }\n      ],\n      'values': [\n        'Underground',\n        'Skyscraper',\n        'House'\n      ]\n    },\n    {\n      'key': 'FRA1',\n      'label': 'Code',\n      'type': 'number',\n      'attributes': [\n        {\n          'key': 'minlength',\n          'value': '5'\n        },\n        {\n          'key': 'required',\n          'value': 'true'\n        },\n        {\n          'key': 'maxlength',\n          'value': '5'\n        }\n      ],\n      'values': []\n    },\n    {\n      'key': 'FRA2',\n      'label': 'Additional Instructions',\n      'type': 'text',\n      'attributes': [\n        {\n          'key': 'maxlength',\n          'value': '50'\n        }\n      ],\n      'values': []\n    }\n  ]\n}\n"
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    \"code\": \"E002\",\n    \"description\": \"The country does not exist in our system.\",\n    \"timestamp\": \"2022-02-16T13:48:05.61+01:00\"\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '405':
          description: Method not allowed
  /emergencyservices/orders:
    parameters: []
    get:
      tags:
      - Emergency Services
      summary: Get list of all emergency services orders by query parameters
      description: This method allows you to get a paged list of all your Emergency Services orders
      operationId: get Emergency Services Orders
      parameters:
      - name: country
        in: query
        description: Country code in ISO 3166-1 alpha-3 format
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: Country code in ISO 3166-1 alpha-3 format
          readOnly: false
          example: BEL
      - name: status
        in: query
        description: Status of emergency service order
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: Status of emergency service order
          readOnly: false
          example: DRAFT
      - name: sortBy
        in: query
        description: 'Sorting by parameter. Possible values: ''orderId'', ''createdDate'', ''modifiedDate'''
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: 'Sorting by parameter. Possible values: ''orderId'', ''createdDate'', ''modifiedDate'''
          readOnly: false
          example: createdDate
          default: orderId
      - name: sortOrder
        in: query
        description: Sort result ascending or descending
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: Sort result ascending or descending
          readOnly: false
          example: desc
          default: asc
      - name: page
        in: query
        description: Get a specific page for your list of orders
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: Get a specific page for your list of orders
          readOnly: false
          example: '5'
          default: '1'
      - name: pageSize
        in: query
        description: Amount of results per page.  Maximum = 100
        required: false
        allowEmptyValue: false
        schema:
          type: string
          description: Amount of results per page.  Maximum = 100
          readOnly: false
          example: '25'
          default: '25'
      responses:
        '200':
          description: List of emergecy services orders
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EmergencyServiceOrder'
                example: null
              example: "[\n  {\n    'orderId': 2542,\n    'country': 'HRV',\n    'reference': 'TestAPI',\n    'email': 'TestAPI@bics.com',\n    'contactNumber': '+32123345',\n    'additionalNotes': 'Some notes',\n    'quantity': 0,\n    'status': 'draft',\n    'createdDate': '2022-02-15T11:27:49Z',\n    'lastModifiedDate': '2022-02-15T11:27:49Z'\n  },\n  {\n    'orderId': 2541,\n    'country': 'FRA',\n    'reference': null,\n    'email': 'TestAPI@bics.com',\n    'contactNumber': null,\n    'additionalNotes': null,\n    'quantity': 1,\n    'status': 'delivered',\n    'createdDate': '2022-02-15T11:05:16Z',\n    'lastModifiedDate': '2022-02-15T12:25:08Z'\n  }\n]\n"
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code': 'E086',\n    'description': 'Invalid value for parameter 'sortBy'.',\n    'timestamp': '2022-02-16T15:29:11.287+01:00'\n  }\n]\n"
        '401':
          description: the API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: this service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '405':
          description: Method not allowed
    post:
      tags:
      - Emergency Services
      summary: Create an empty Emergency Services Order
      description: 'Create an empty Emergency Services Order for a specific country.  The location to the order is specified in the response header - **location:** /emergencyservices/orders/**{orderId}**.  With the add Order Item, you can now add numbers to your Emergency Services order.

        '
      operationId: create Emergency Services Order
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmergencyServiceOrderCreateRequest'
            example: null
        required: true
      responses:
        '201':
          description: 'Successful operation. Created order id is returned in response header **location:** /emergencyservices/orders/**{orderId}**

            '
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E020',\n    'description' : 'Please fill out all the mandatory attributes.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '405':
          description: Method not allowed
  /emergencyservices/orders/{orderId}:
    parameters: []
    get:
      tags:
      - Emergency Services
      summary: Get emergency service order details by order id
      description: Get the details of a complete Emergency Service Order.
      operationId: get Emergency Service Order Details
      parameters:
      - name: orderId
        in: path
        description: Order Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Id
          format: int64
          readOnly: false
          example: '80'
      responses:
        '200':
          description: Emergency service order details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmergencyServiceOrderDetails'
              example: "{\n  'orderId': 80,\n  'country': 'FRA',\n  'reference': 'TestAPI',\n  'email': 'SomeEmail@bics.com',\n  'contactNumber': null,\n  'additionalNotes': null,\n  'status': 'draft',\n  'createdDate': '2022-02-11T10:42:30Z',\n  'lastModifiedDate': '2022-02-11T10:42:30Z',\n  'quantity': 1,\n  'orderItems': [\n    {\n      'orderItemId': 20725,\n      'accessNumber': '33185464561',\n      'addressReference': '394431',\n      'additionalInformation': [\n        {\n          'key': 'FRA2',\n          'label': 'Additional Instructions',\n          'value': null\n        },\n        {\n          'key': 'FRA1',\n          'label': 'Code',\n          'value': null\n        },\n        {\n          'key': 'FRA3',\n          'label': 'Building',\n          'value': null\n        }\n      ]\n    }\n  ]\n}\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '405':
          description: Method not allowed
    delete:
      tags:
      - Emergency Services
      summary: Cancel emergency service order by order id
      description: Cancellation of an Emergency Services Order is allowed when the status = "Draft".
      operationId: cancel Emergency Service Order
      parameters:
      - name: orderId
        in: path
        description: Unique identifier for an emergency service order
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Unique identifier for an emergency service order
          format: int64
          readOnly: false
          example: '10564'
      responses:
        '200':
          description: Successful operation.
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E123',\n    'description' : 'DELETE is not possible due to current status.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '405':
          description: Method not allowed
    patch:
      tags:
      - Emergency Services
      summary: Update emergency service order by order id
      description: Update Emergency Services Order.
      operationId: update Emergency Service Order
      parameters:
      - name: orderId
        in: path
        description: Order Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Id
          format: int64
          readOnly: false
          example: '80'
      requestBody:
        description: Emergency Service order request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmergencyServiceOrderUpdateRequest'
            example: null
        required: true
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmergencyServiceOrder'
              example: "{\n  'orderId': 80,\n  'country': 'FRA',\n  'reference': 'TestAPI',\n  'email': 'SomeEmail@bics.com',\n  'contactNumber': '+32123345',\n  'additionalNotes': 'Some Notes',\n  'quantity': 1,\n  'status': 'draft',\n  'createdDate': '2022-02-02T19:06:07Z',\n  'lastModifiedDate': '2022-02-16T16:21:17.045Z'\n}\n"
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code': 'E035',\n    'description': 'The length of the attribute 'reference' is too long. The maximum length for this attribute is 255 characters.',\n    'timestamp': '2022-02-16T17:26:22.17+01:00'\n  }\n]\n"
        '401':
          description: the API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: this service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2019-07-11T15:16:49.53+02:00'\n  }\n]\n"
        '405':
          description: Method not allowed
  /emergencyservices/orders/{orderId}/orderitems:
    parameters: []
    post:
      tags:
      - Emergency Services
      summary: Create emergency service order item for order
      description: Add numbers to your Emergency Services Order. A number must be in the same country as the Order, must have a valid address linked to it, and Emergency Services is available. This can be checked by calling the '/numbers/{number}' and '/numbers/{number}/services' API.
      operationId: create Emergency Service Order Item
      parameters:
      - name: orderId
        in: path
        description: Order Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Id
          format: int64
          readOnly: false
          example: '80'
      requestBody:
        description: An object containing emergency service order item properties
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderItemRequest'
            example: null
        required: true
      responses:
        '200':
          description: Successful operation.
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E064',\n    'description' : 'The country, which specified in the order, doesn't match to the country of access number.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2019-07-11T15:16:49.53+02:00'\n  }\n]\n"
  /emergencyservices/orders/{orderId}/orderitems/{orderItemId}:
    parameters: []
    delete:
      tags:
      - Emergency Services
      summary: Delete emergency service order item by order id
      description: Remove a number from your order. This method is only allowed when the status is 'Draft' or 'On hold'.
      operationId: delete Emergency Service Order Item
      parameters:
      - name: orderId
        in: path
        description: Order Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Id
          format: int64
          readOnly: false
          example: '80'
      - name: orderItemId
        in: path
        description: Order Item Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Item Id
          format: int64
          readOnly: false
          example: '120'
      responses:
        '200':
          description: Successful operation.
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E123',\n    'description' : 'DELETE is not possible due to current status.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available.
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2019-07-11T15:16:49.53+02:00'\n  }\n]\n"
    patch:
      tags:
      - Emergency Services
      summary: Request to update emergency service order item properties
      operationId: update Emergency Service Order Item
      parameters:
      - name: orderId
        in: path
        description: Emergency service order id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Emergency service order id
          format: int64
          readOnly: false
          example: '80'
      - name: orderItemId
        in: path
        description: Emergency service order item id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Emergency service order item id
          format: int64
          readOnly: false
          example: '120'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderItemUpdateRequest'
            example: null
        required: true
      responses:
        '200':
          description: Successful operation.
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code': 'E081',\n    'description': 'Request payload is invalid.',\n    'timestamp': '2022-02-16T16:56:28.785+01:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Internal server error
        '403':
          description: This service cannot be used according to your API Key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order or order item does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2019-07-11T15:16:49.53+02:00'\n  }\n]\n"
        '405':
          description: Method not allowed
  /emergencyservices/orders/{orderId}/submit:
    parameters: []
    post:
      tags:
      - Emergency Services
      summary: Request to submit emergency service order
      description: Submit your order so that we can start processing it and enable Emergency Services as soon as possible.
      operationId: submit Emergency Service Order
      parameters:
      - name: orderId
        in: path
        description: Order Id
        required: true
        allowEmptyValue: false
        schema:
          type: integer
          description: Order Id
          format: int64
          readOnly: false
          example: '80'
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitEmergencyServiceResponse'
              example: "{\n  'orderId': 2502,\n  'status': 'SUBMITTED'\n}\n"
        '400':
          description: Bad request, An issue occurred while processing the input parameters.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code': 'E128',\n    'description': 'Submit is not possible due to current status.',\n    'timestamp': '2022-02-16T16:08:53.528+01:00'\n  }\n]\n"
        '401':
          description: The API Key was not mentioned or is invalid (see authentication)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '500':
          description: Service not available
        '403':
          description: This service cannot be used according to your API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
              example: null
        '404':
          description: Order does not exist
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/error'
                example: null
              example: "[\n  {\n    'code' : 'E100',\n    'description' : 'There is no order with this identifier in our system. Please correct the identifier.'\n    'timestamp' : '2022-01-01T15:16:49.53+02:00'\n  }\n]\n"
        '405':
          description: Method not allowed
components:
  schemas:
    OrderItemCountryConfig:
      type: object
      properties:
        tooltip:
          type: string
          description: Tooltip of country specific field
          example: null
        label:
          type: string
          description: Label for country specific field
          example: null
        value:
          type: string
          description: Value of country specific field
          example: null
        key:
          type: string
          description: Key of country specific field
          example: null
      example: null
    EmergencyServiceCountryConfigInfo:
      type: object
      properties:
        values:
          type: array
          description: Possible values for a country specific field of type 'select'
          items:
            type: string
            example: null
          example: null
        tooltip:
          type: string
          description: Tooltip for the field.
          example: null
        attributes:
          type: array
          description: List of restrictions for country specific field
          items:
            $ref: '#/components/schemas/EmergencyServiceCountryConfigAttribute'
          example: null
        label:
          type: string
          description: Description of the field.
          example: null
        type:
          type: string
          description: 'Type of field. Possible types: ''number'', ''text'', ''select'', ''date''.'
          example: null
        key:
          type: string
          description: Unique key per country specific requirement.
          example: null
      example: null
    EmergencyServiceOrderCreateRequest:
      required:
      - country
      - email
      type: object
      properties:
        reference:
          type: string
          description: Your reference
          example: null
        country:
          type: string
          description: Country code in ISO 3166-1 alpha-3 format
          example: null
        contactNumber:
          type: string
          description: Your telephone number, multiple numbers are separated by semi-colon ';'.
          example: null
        additionalNotes:
          type: string
          description: Your additional information about this Emergency Services Order.
          example: null
        email:
          type: string
          description: Address(es) of Emergency Services order responsible(s), multiple addresses are separated by semi-colon ';'. This value is included in all communications regarding this request.
          example: null
      example: null
    OrderItem:
      required:
      - accessNumber
      - addressReference
      type: object
      properties:
        additionalInformation:
          type: array
          description: Additional information
          items:
            $ref: '#/components/schemas/OrderItemCountryConfig'
          example: null
        addressReference:
          maxLength: 100
          minLength: 1
          type: string
          description: Address reference
          example: null
        accessNumber:
          maxLength: 100
          minLength: 1
          type: string
          description: Access number
          example: null
        orderItemId:
          type: integer
          description: Unique identifier per item in an Emergency Services Order
          format: int64
          example: null
      example: null
    EmergencyServiceOrder:
      type: object
      properties:
        reference:
          type: string
          description: Your reference
          example: null
        country:


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bics-network/refs/heads/main/openapi/bics-network-emergency-services-api-openapi.yml