swagger-spec-users.yaml

swagger: "2.0"
info:
    title: Venmo API
    description: The Venmo API.
    termsOfService: https://venmo.com/legal/us-user-agreement/
    contact:
      name: Venmo API Support
      url: https://developer.venmo.com
      email: developer@venmo.com
    version: "1.0"
host: api.venmo.com
basePath: /v1/
schemes:
  - https
produces:
  - application/json
paths:
    /users/{id}:
        get:
          description: Returns a user based on a single ID
          operationId: find user by id
          parameters:
            - name: id
              in: path
              description: The ID of a user
              required: true
              type: integer
              format: int64
          responses:
            200:
              description: user response
              schema:
                $ref: '#/definitions/User'
            default:
              description: unexpected error
              schema:
                $ref: '#/definitions/Error'


definitions:
    User:
        required:
            - id
            - username
        properties:
            id:
                type: integer
                format: int64
            username:
                type: string    
            first_name:
                type: string    
            last_name:
                type: string    
            display_name:
                type: string 
            about:
                type: string   
            profile_picture_url:
                type: string 
                format: url        
            date_joined:
                type: string
                format: date-time    
            email:
                type: string
                format: email
            phone:
                type: string
                format: phone   
            is_friend:
                type: boolean
            friends_count:
                type: integer
                format: double
    Error:
        required:
          - code
          - message
        properties:
          code:
            type: integer
            format: int32
          message:
            type: string