RAML API specification example depicting GET usage

accounts-sapi.raml

#%RAML 1.0
title: Accounts SAPI

types:
  account:
    type: object
    properties:
      login:
      name:
      surname:
      role:
      email?:
      rank:
        type: integer
        default: 0


/accounts:
  get:
     queryParameters:
      surname?:
      role?:
      rank?:
        type: integer
     responses:
       200:
         body:
           application/json:
             type: array
             items:
               type: account
               example:
                 login: adoe
                 name: adrian
                 surname: doe
                 role: ADMIN
                 rank: 20
           application/xml:
             type: array
             items:
               type: account
       415:
         description: Unsupported Media Type
  /{login}:
      get:
        responses:
          200:
            body:
              application/json:
                type: account
              application/xml:
                  type: account