> ## Documentation Index
> Fetch the complete documentation index at: https://entendre.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List sources

> Lists sources across the supported providers.

Source-type permissions apply to the results.


## OpenAPI

````yaml openapi-public-preview.json GET /v1/sources
openapi: 3.1.0
info:
  title: Entendre API
  version: 1.0.0
  description: Programmatic access to crypto-native accounting and treasury operations.
servers:
  - url: https://api.entendre.finance
    description: Production API.
security:
  - ApiKey: []
tags:
  - name: Organization
    description: Read your organization profile and find members for agent assignments.
  - name: Transactions
    description: Find transactions, inspect their details and create manual records.
  - name: Sources
    description: >-
      Manage wallets, exchange accounts, bank accounts and other transaction
      sources.
  - name: Assets
    description: Inspect asset acquisitions, remaining quantities and cost basis.
  - name: Journals
    description: >-
      Create and post journal entries, correct eligible entries and sync posted
      journals to a connected general ledger.
  - name: Documents
    description: >-
      Upload documents, check processing status and link supporting evidence to
      transactions.
  - name: Legal Entities
    description: Manage the legal entities used in your accounting records.
  - name: Ledger Accounts
    description: Manage your chart of accounts and find accounts for journal entries.
  - name: Tags
    description: Create and manage tags to classify your records.
  - name: Accruals
    description: >-
      Create and post accruals, inspect their status and reverse eligible
      entries.
  - name: Cash Application
    description: Match deposits to invoices and manage the resulting cash applications.
  - name: Classification
    description: >-
      Classify transactions in a batch, post eligible entries and inspect the
      results.
  - name: Revaluation
    description: Run asset revaluations for an accounting period and check their results.
  - name: Accounting Periods
    description: Check whether a period is ready to close, then close or reopen it.
  - name: Income Statement
    description: View revenue, expenses and net income for a reporting period.
  - name: Balance Sheet
    description: View assets, liabilities and equity as of a reporting date.
  - name: Trial Balance
    description: Review ledger account balances and debit and credit totals.
  - name: Closing Positions
    description: View asset positions at the end of a reporting period.
  - name: Treasury Balances
    description: Review treasury balances by asset and source.
  - name: Realized Gains & Losses
    description: Review realized gains and losses from asset dispositions.
  - name: Asset Tax Lots
    description: Inspect asset tax lots, remaining quantities and cost basis.
  - name: Schedule of Dispositions
    description: >-
      Review asset dispositions and their proceeds, cost basis and gains or
      losses.
  - name: Financial Insights
    description: Review financial insights for your selected reporting context.
  - name: Agents
    description: Create agents, schedule their work and inspect their runs.
  - name: Memory
    description: Read, search and maintain the memory files your agents use.
  - name: Connections
    description: Connect providers, manage authorization and disconnect.
  - name: GL Mapping
    description: >-
      Map ledger accounts and legal entities to your ERP. Import legal entities,
      tags and chart of accounts.
  - name: Request
    description: Request information, documents or connections from a client.
  - name: Client
    description: Manage your firm’s client relationships.
  - name: Team
    description: Invite team members and manage their access to your firm.
  - name: Settings
    description: Read and update your firm settings.
paths:
  /v1/sources:
    get:
      tags:
        - Sources
      summary: List sources
      description: >-
        Lists sources across supported providers. Pass one ID in `source_ids` to
        retrieve one record. Returns a paginated array, including when filtering
        by ID. No matches returns HTTP 200 with an empty `data` array.


        Source-type permissions still apply.
      operationId: list_sources
      parameters:
        - name: legal_entity_ids
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: >-
            Filter by one or more legal entity IDs. Omit to include all
            authorized entities. An empty list is invalid.
        - name: source_types
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
              enum:
                - exchange
                - staking
                - niural
                - raincard
                - ramp_card
                - ramp_bank_account
                - manual_bank
                - wallet
                - plaid_account
          description: >-
            Filter by one or more source types. Repeat the parameter or send a
            comma-separated list.
        - name: providers
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: >-
            Filter by provider labels. A provider with no matching source type
            returns an empty page.
        - name: source_ids
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: IDs to return, separated by commas. The other filters also apply.
        - name: addresses
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: >-
            Wallet addresses, up to 100. Matching ignores case. Returns wallets
            only.
        - name: include_count
          in: query
          schema:
            type: boolean
          description: >-
            Include the total number of matching records. If the count cannot be
            calculated, the request fails.
        - name: tag_ids
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: >-
            Prefixed `tag_` ids. Supported by wallets and exchange sources; a
            type that cannot filter on tags is excluded from the results when
            this is set.
        - name: statuses
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
              enum:
                - active
                - archived
                - pending_setup
          description: >-
            Any of these lifecycle statuses. Source types without a lifecycle
            status are excluded when this filter is set.
        - name: chains
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
          description: >-
            Chain identifiers (such as `eth`). This filter returns wallets only.
            Other source types are excluded.
        - name: wallet_types
          in: query
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
              enum:
                - internal
                - external
          description: >-
            Wallet types, lowercase. Supported by wallets and Niural sources;
            every other type is excluded from the results when this is set.
        - name: limit
          in: query
          required: false
          description: Maximum number of records to return.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: cursor
          in: query
          required: false
          description: >-
            The `next_cursor` value from the previous page. Keep the other
            filters unchanged.
          schema:
            type: string
        - name: search
          in: query
          required: false
          description: Case-insensitive search in labels and descriptions.
          schema:
            type: string
        - name: type
          in: query
          required: false
          description: Filter by one source type.
          schema:
            type: string
            enum:
              - exchange
              - staking
              - niural
              - raincard
              - ramp_card
              - ramp_bank_account
              - manual_bank
              - wallet
              - plaid_account
        - name: group_id
          in: query
          schema:
            type: string
          description: >-
            Source group ID (`sgp_…`), or `null` for sources in no group.
            Staking sources cannot be in a group.
        - name: expand
          in: query
          schema:
            type: string
            enum:
              - group
          description: >-
            Related records to include. `group` adds the source group of each
            source (`null` when it has none) and needs the `read:source-groups`
            scope.
      responses:
        '200':
          description: The matching records.
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Source'
                    description: The records.
                  has_more:
                    type: boolean
                    description: Whether another page is available.
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: Cursor for the next page, or `null` on the last page.
                  total_count:
                    type: integer
                    minimum: 0
                    description: >-
                      Total matching records across all pages. Present when
                      include_count=true.
                required:
                  - data
                  - has_more
                  - next_cursor
                additionalProperties: false
              example:
                data:
                  - id: src_507f1f77bcf86cd799439011
                    source_type: wallet
                    organization_id: null
                    legal_entity_id: null
                    name: Treasury wallet
                    status: active
                    created_at: null
                    updated_at: null
                    detail:
                      address: '0x0000000000000000000000000000000000000001'
                      chain: eth
                      has_credentials: false
                      ledger_account_id: null
                has_more: false
                next_cursor: null
        '400':
          description: >-
            The request is invalid. `error.fields` lists the fields to correct.
            Nothing was changed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: VALIDATION_ERROR
                  message: Invalid path, query or request body.
                  request_id: req_example
        '401':
          description: The API key is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: UNAUTHORIZED
                  message: Authentication is required.
                  request_id: req_example
        '403':
          description: >-
            The API key does not have the required scope or is not associated
            with a user, or the action needs a review in the dashboard.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: FORBIDDEN
                  message: Insufficient access to organization
                  request_id: req_example
        '404':
          description: The resource does not exist, or your organization cannot access it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: RESOURCE_NOT_FOUND
                  message: Resource not found
                  request_id: req_example
        '429':
          description: >-
            Too many requests. If the response has a `Retry-After` header, wait
            that many seconds before you retry. Otherwise, read `error.message`.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: RATE_LIMITED
                  message: Rate limit exceeded. Retry after 30s.
                  request_id: req_example
        '500':
          description: >-
            An unexpected error occurred. A write can still have taken effect;
            check the resource before you retry. Give the `request_id` to
            support.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: INTERNAL_ERROR
                  message: Internal server error
                  request_id: req_example
        '503':
          description: >-
            A service that this operation needs is unavailable. If the response
            has a `Retry-After` header, wait that many seconds. Check for
            earlier accepted work before you send the request again.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: SERVICE_UNAVAILABLE
                  message: Service unavailable.
                  request_id: req_example
components:
  schemas:
    Source:
      type: object
      required:
        - id
        - source_type
        - organization_id
        - legal_entity_id
        - name
        - status
        - created_at
        - updated_at
        - detail
      properties:
        id:
          type: string
          description: Source ID.
          example: src_507f1f77bcf86cd799439011
        source_type:
          type: string
          description: Source type. It determines the fields in `detail`.
          enum:
            - exchange
            - staking
            - niural
            - raincard
            - ramp_card
            - ramp_bank_account
            - manual_bank
            - wallet
            - plaid_account
        organization_id:
          type:
            - string
            - 'null'
          description: Organization ID (`org_…`).
        legal_entity_id:
          type:
            - string
            - 'null'
          description: Legal entity of the source (`le_…`), or `null`.
        name:
          type:
            - string
            - 'null'
          description: >-
            Display name, such as the card nickname or the bank name and last
            four digits.
        status:
          type: string
          description: Source status.
          enum:
            - active
            - archived
        created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Time the source was created (ISO 8601).
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Time the source was last updated (ISO 8601).
        detail:
          $ref: '#/components/schemas/SourceDetail'
        group_id:
          type:
            - string
            - 'null'
          description: >-
            Prefixed `sgp_` id of the source group this source belongs to, or
            null when it is not in one. Always null for `staking`, which cannot
            be grouped.
        group:
          description: >-
            The full source group, present only when the request passed
            `expand=group`. Null when the source is ungrouped.
          oneOf:
            - $ref: '#/components/schemas/V1SourceGroup'
            - type: 'null'
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Technical description for developers.
            fields:
              type: object
              additionalProperties:
                type: string
              description: >-
                Present only on VALIDATION_ERROR. Maps failing field paths to
                reason strings.
            details:
              type: object
              additionalProperties: true
              description: >-
                Optional redacted diagnostic details. Request validation uses
                fields or field_errors.
            suggested_action:
              type: string
              description: A suggested next step.
            documentation_url:
              type: string
              format: uri
              description: Link to documentation about this error.
            request_id:
              type: string
              description: Unique request ID for support escalation.
          description: Error details.
    SourceDetail:
      type: object
      properties:
        address:
          type:
            - string
            - 'null'
          description: Wallet address where relevant.
        chain:
          type:
            - string
            - 'null'
          description: Network identifier.
        bank_name:
          type:
            - string
            - 'null'
          description: Bank institution.
        account_name:
          type:
            - string
            - 'null'
          description: Account label.
        account_number_last_four:
          type:
            - string
            - 'null'
          description: Masked last four only.
        card_last4:
          type:
            - string
            - 'null'
          description: Masked card last four.
        exchange_source_type:
          type:
            - string
            - 'null'
          description: Exchange provider.
        has_credentials:
          type: boolean
          description: Whether credentials are stored. The credential is never returned.
        credential_status:
          type:
            - string
            - 'null'
          description: Provider authorization state.
        ledger_account_id:
          type:
            - string
            - 'null'
          description: >-
            The single ledger account assigned to this source. Null when no
            account is assigned.
          example: lac_507f1f77bcf86cd799439011
      additionalProperties: false
      description: Details for the source type.
    V1SourceGroup:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
          description: Prefixed `sgp_` id.
        organization_id:
          type:
            - string
            - 'null'
          description: Prefixed `org_` id.
        name:
          type:
            - string
            - 'null'
          description: Group name.
        icon:
          type:
            - string
            - 'null'
          description: Group icon.
        emoji:
          type:
            - string
            - 'null'
          description: Group emoji.
        reference_wallet_id:
          type:
            - string
            - 'null'
          description: Wallet (`wal_…`) linked to the group, if any.
        created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Time the source group was created (ISO 8601).
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Time the source group was last updated (ISO 8601).
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your organization API key. Some operations also need a key that is
        associated with a user; their pages say so.

````