MTN EEC Token Management

swagger: '2.0'
info:
  description: This API provides EEC Token Management
  version: 1.0.0
  title: GENEYSIS - EEC TOKENS MANAGEMENT API-mtn
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
securityDefinitions:
  ApiKeyAuth:
    type: "apiKey"
    name: "X-API-Key"
    in: "header"
security:
  - ApiKeyAuth: []
host: api.mtn.com
basePath: /v1/eec/
paths:
  /eecToken/{msisdn}/{accountRef}:
    get:
      tags:
        - GENEYSIS-EEC-TOKENS
      operationId: geteecTokensFromDBUsingGet
      produces:
        - '*/*'
      parameters:
        - name: accountRef
          in: path
          description: accountRef
          required: true
          type: string
        - name: countryCode
          in: header
          description: countryCode
          required: true
          type: string
        - name: msisdn
          in: path
          description: msisdn
          required: true
          type: string
      responses:
        "200":
          description: Success
          schema:
            type: object
            properties:
              statusCode:
                type: string
                description: "This is the MADAPI Canonical response Code (it is 4 characters long and it is not the HTTP Status Code which is 3 characters long). Back-end system response are mapped to specific canonical response codes which are returned. More information on these mappings can be found on the MADAPI Confluence Page 'Response Codes'"
              statusMessage:
                type: string
                description: "Status Message"
              transactionId:
                type: string
                description: "API generated Id to include for tracing requests"
              data:
                $ref: '#/definitions/EecTokenResponse'
              _links:
                type: object
                properties:
                  self:
                    type: string
                    example: "https://api.mtn/app/v1/eec/eecToken/2323464618463/acc-23464618463"

        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/Error'
        "401":
          description: Unauthorized
          schema:
            $ref: '#/definitions/Error'
        "403":
          description: Forbidden
          schema:
            $ref: '#/definitions/Error'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/Error'
definitions:
  EecTokenResponse:
    type: object
    properties:
      accountNo:
        type: string
      dateOfPurchase:
        type: string
      origRef:
        type: string
      amount:
        type: string
      tokens:
        type: array
        items:
          type: string
    title: EecTokenResponse
  Error:
    type: object
    required:
      - "statusCode"
      - "statusMessage"
    properties:
      statusCode:
        type: string
        description: This is the MADAPI Canonical Error Code (it is 4 characters long and it is not the HTTP Status Code which is 3 characters long). Back-end system errors are mapped to specific canonical error codes which are returned. More information on these mappings can be found on the MADAPI Confluence Page 'Response Codes'
        example: '1000'
      statusMessage:
        type: string
        description: More details and corrective actions related to the error which can be shown to a client
      supportMessage:
        type: string
        description: Internal message meant for consumers of the API to troubleshoot the error (could possible include the back-end system error code in the message if it would be useful)
      transactionId:
        type: string
        description: API generated Id to include for tracing requests
      timestamp:
        type: string
        format: date-time
        description: Timestamp of the error
        example: "2019-08-23T07:29:25.593+0000"
      _links:
        type: object
        properties:
          self:
            type: object
            properties:
              href:
                type: string
                example: "https://api.mtn/app/v1/eec/eecToken/2323464618463/acc-23464618463"