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

# List the file formats the org can import

> Returns every import format available to the org, with each field's type, whether it is required, a description, example values and the column headers it is read from. Payroll formats are offered only for payroll providers the org has connected. Formats with requires_account need an uploaded bank or card account from list_uploaded_accounts.



## OpenAPI

````yaml https://app.usequanta.com/openapi/quanta-services-api/openapi.json get /api/uploaded_sources/formats
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://app.usequanta.com
    description: Production
security:
  - HTTPBearer: []
paths:
  /api/uploaded_sources/formats:
    get:
      tags:
        - uploaded_sources
        - quanta-services-api
      summary: List the file formats the org can import
      description: >-
        Returns every import format available to the org, with each field's
        type, whether it is required, a description, example values and the
        column headers it is read from. Payroll formats are offered only for
        payroll providers the org has connected. Formats with requires_account
        need an uploaded bank or card account from list_uploaded_accounts.
      operationId: list_uploaded_source_formats
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadedSourceFormatCatalog'
      security:
        - HTTPBearer: []
components:
  schemas:
    UploadedSourceFormatCatalog:
      properties:
        formats:
          items:
            $ref: '#/components/schemas/UploadedSourceFormat'
          type: array
          title: Formats
        last_used:
          anyOf:
            - $ref: '#/components/schemas/LastUsedUploadedSource'
            - type: 'null'
      type: object
      required:
        - formats
        - last_used
      title: UploadedSourceFormatCatalog
    UploadedSourceFormat:
      properties:
        name:
          $ref: '#/components/schemas/UploadedSourceFormatName'
        source_type:
          $ref: '#/components/schemas/UploadedSourceType'
        label:
          type: string
          title: Label
        fields:
          items:
            $ref: '#/components/schemas/FieldSpec'
          type: array
          title: Fields
        mapping_editable:
          type: boolean
          title: Mapping Editable
        requires_account:
          type: boolean
          title: Requires Account
        template_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Template Url
      type: object
      required:
        - name
        - source_type
        - label
        - fields
        - mapping_editable
        - requires_account
        - template_url
      title: UploadedSourceFormat
    LastUsedUploadedSource:
      properties:
        format:
          $ref: '#/components/schemas/UploadedSourceFormatName'
        uploaded_account_qid:
          anyOf:
            - type: string
            - type: 'null'
          title: Uploaded Account Qid
      type: object
      required:
        - format
        - uploaded_account_qid
      title: LastUsedUploadedSource
    UploadedSourceFormatName:
      type: string
      enum:
        - GENERIC_BANK
        - GENERIC_CARD
        - GENERIC_REIMBURSEMENT
        - GENERIC_INVOICE
        - GENERIC_BILL
        - PAYROLL_JUSTWORKS
        - PAYROLL_JUSTWORKS_PEO_INVOICE
        - PAYROLL_WARP
        - PAYROLL_CENTRAL
        - PAYROLL_SEQUOIA_ONE
      title: UploadedSourceFormatName
    UploadedSourceType:
      type: string
      enum:
        - BANK
        - CARD
        - REIMBURSEMENT
        - PAYROLL
        - INVOICE
        - BILL
      title: UploadedSourceType
    FieldSpec:
      properties:
        name:
          $ref: '#/components/schemas/CanonicalField'
        label:
          type: string
          title: Label
        kind:
          $ref: '#/components/schemas/FieldKind'
        required:
          type: boolean
          title: Required
        description:
          type: string
          title: Description
        examples:
          items:
            type: string
          type: array
          title: Examples
        header_synonyms:
          items:
            type: string
          type: array
          title: Header Synonyms
      type: object
      required:
        - name
        - label
        - kind
        - required
        - description
        - examples
        - header_synonyms
      title: FieldSpec
    CanonicalField:
      type: string
      enum:
        - TRANSACTION_DATE
        - AMOUNT
        - DESCRIPTION
        - REFERENCE_NUMBER
        - MEMO
        - GROSS_PAY
        - NET_PAY
        - CUSTOMER
        - VENDOR
        - DUE_DATE
        - PRODUCT
        - TAX_AMOUNT
        - SERVICE_PERIOD_START
        - SERVICE_PERIOD_END
        - CURRENCY
      title: CanonicalField
    FieldKind:
      type: string
      enum:
        - DATE
        - MONETARY_AMOUNT
        - CURRENCY
        - TEXT
      title: FieldKind
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Quanta Services API scoped bearer token. Supported only on Services API
        routes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.