openapi: 3.2.0
info:
  description: User API to be consumed by the clients that are not companies and that are connecting their individual accounts
  title: User Accounts API
  contact: {}
  version: '05'
servers:
- url: https://api.getrollee.com/api/v0.5
tags:
- name: Accounts
paths:
  /accounts/{id}:
    get:
      description: Get information related to an account
      tags:
      - Accounts
      summary: Get account information
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: account id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Account'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: getAccountsById
      x-operation-id-source: derived
    delete:
      description: Delete an account belonging to a User
      tags:
      - Accounts
      summary: Delete an Account
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: account id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.StatusResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: deleteAccountsById
      x-operation-id-source: derived
  /accounts/{id}/approve_device:
    post:
      description: Approve a new device login for an account
      tags:
      - Accounts
      summary: Approve device
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: account id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.StatusResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: postAccountsByIdApproveDevice
      x-operation-id-source: derived
  /accounts/{id}/disconnect:
    post:
      description: Set the account as disconnected so that Rollee will not update it anymore until it gets reconnected
      tags:
      - Accounts
      summary: Disconnect account
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: account id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Account'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: postAccountsByIdDisconnect
      x-operation-id-source: derived
  /accounts/{id}/reconnect:
    post:
      description: Create a reconnect session for an account
      tags:
      - Accounts
      summary: Account reconnect session
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: account id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.UserSessionResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: postAccountsByIdReconnect
      x-operation-id-source: derived
  /users/{id}/accounts:
    get:
      description: Get all accounts belonging to a User
      tags:
      - Accounts
      summary: Get Accounts
      parameters:
      - description: Bearer <JWT token>
        name: Authorization
        in: header
        required: true
        schema:
          type: string
      - description: user id
        name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/account.Account'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.ServerError'
      operationId: getUsersByIdAccounts
      x-operation-id-source: derived
components:
  schemas:
    account.Account:
      type: object
      properties:
        connected:
          type: boolean
        created_at:
          type: string
        datasource_id:
          type: string
        id:
          type: string
        name:
          type: string
        reconnecting:
          type: boolean
        type:
          type: string
        updated_at:
          type: string
        user_id:
          type: string
    models.StatusResponse:
      type: object
      properties:
        status:
          description: Status will always be "success"
          type: string
          example: success
    models.UserSessionResponse:
      type: object
      properties:
        link:
          type: string
        session:
          type: string
        session_expires_at:
          type: string
    models.ServerError:
      type: object
      properties:
        error:
          type: string
    models.Account:
      type: object
      properties:
        connected:
          type: boolean
        created_at:
          type: string
        datasource:
          type: string
        datasource_id:
          type: string
        id:
          type: string
        name:
          type: string
        type:
          type: string
        updated_at:
          type: string
        user_id:
          type: string
x-provenance:
  method: searched
  source: https://developers.getrollee.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developers.getrollee.com/reference/delete_accounts-id-1.md
  - https://developers.getrollee.com/reference/delete_users-id-1.md
  - https://developers.getrollee.com/reference/delete_webhooks-type-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-activity-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-assets-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-banking-info-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-bonuses-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-documents-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-employment-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-income-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-orders.md
  - https://developers.getrollee.com/reference/get_accounts-id-performance-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-profile-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-purchase-intent.md
  - https://developers.getrollee.com/reference/get_accounts-id-taxes.md
  - https://developers.getrollee.com/reference/get_accounts-id-transactions-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-trips-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-vehicles-1.md
  - https://developers.getrollee.com/reference/get_accounts-id-wallet-1.md
  - https://developers.getrollee.com/reference/get_data-settings-1.md
  - https://developers.getrollee.com/reference/get_data-sources-1.md
  - https://developers.getrollee.com/reference/get_token-refresh-2.md
  - https://developers.getrollee.com/reference/get_users-1.md
  - https://developers.getrollee.com/reference/get_users-id-2.md
  - https://developers.getrollee.com/reference/get_users-id-accounts-1.md
  - https://developers.getrollee.com/reference/get_users-id-performance-index-1.md
  - https://developers.getrollee.com/reference/get_webhooks-2.md
  - https://developers.getrollee.com/reference/get_webhooks-v2-1.md
  - https://developers.getrollee.com/reference/post_accounts-id-approve-device.md
  - https://developers.getrollee.com/reference/post_accounts-id-disconnect-1.md
  - https://developers.getrollee.com/reference/post_accounts-id-reconnect-1.md
  - https://developers.getrollee.com/reference/post_sessions-session-refresh-2.md
  - https://developers.getrollee.com/reference/post_users-1.md
  - https://developers.getrollee.com/reference/post_users-id-sessions-new-1.md
  - https://developers.getrollee.com/reference/put_users-id-2.md
  - https://developers.getrollee.com/reference/put_webhooks-accounts-1.md
  - https://developers.getrollee.com/reference/put_webhooks-endpoints-1.md
  - https://developers.getrollee.com/reference/put_webhooks-multi-endpoints-1.md
  - https://developers.getrollee.com/reference/put_webhooks-rollee-connect-events-1.md
  - https://developers.getrollee.com/reference/put_webhooks-users-1.md
  merge:
    pages: 41
    deduped: 84
    conflicts_kept_first: 0