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

# List where a file's columns can go

> Every place a file feed can put a column: standard and custom account fields, product usage dimensions, custom objects' fields (and each object's external id column), and person fields. Each target has its type and writable, with the reason when a feed may not write it (another source owns it, AI fills it, or a feed can't load its type). The rules a feed is held to come with them: the identifier fields, date formats and periods. Read this before mapping a file's columns; search narrows it.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/integrations/imports/targets
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/integrations/imports/targets:
    get:
      tags:
        - integrations
      summary: List where a file's columns can go
      description: >-
        Every place a file feed can put a column: standard and custom account
        fields, product usage dimensions, custom objects' fields (and each
        object's external id column), and person fields. Each target has its
        type and writable, with the reason when a feed may not write it (another
        source owns it, AI fills it, or a feed can't load its type). The rules a
        feed is held to come with them: the identifier fields, date formats and
        periods. Read this before mapping a file's columns; search narrows it.
      operationId: integrations_import_targets
      parameters:
        - description: Only targets whose target or label holds this
          in: query
          name: search
          required: false
          schema:
            anyOf:
              - maxLength: 1000
                type: string
              - type: 'null'
            default: null
        - description: Only targets of this kind
          in: query
          name: kind
          required: false
          schema:
            anyOf:
              - enum:
                  - account
                  - usage
                  - object
                  - person
                type: string
              - type: 'null'
            default: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportTargetsResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    ImportTargetsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ImportTarget'
          title: Data
          type: array
        rules:
          $ref: '#/components/schemas/ImportRules'
      required:
        - data
        - rules
      title: ImportTargetsResponse
      type: object
    ImportTarget:
      properties:
        kind:
          enum:
            - account
            - usage
            - object
            - person
          title: Kind
          type: string
        label:
          title: Label
          type: string
        object:
          anyOf:
            - type: string
            - type: 'null'
          description: An object target's object key
          title: Object
        product:
          anyOf:
            - type: string
            - type: 'null'
          description: A usage target's product id
          title: Product
        reason:
          anyOf:
            - type: string
            - type: 'null'
          description: Why not, when writable is false
          title: Reason
        required:
          default: false
          description: >-
            Must be mapped: an object's external id and mandatory fields, a
            person's email
          title: Required
          type: boolean
        target:
          description: What a column entry names
          title: Target
          type: string
        type:
          description: As fields.list names types (text, number, date, picklist, …)
          title: Type
          type: string
        writable:
          description: Whether a feed may map a column here
          title: Writable
          type: boolean
      required:
        - target
        - kind
        - label
        - type
        - writable
        - reason
      title: ImportTarget
      type: object
    ImportRules:
      properties:
        date_formats:
          description: The date_format values a date column may take
          items:
            type: string
          title: Date Formats
          type: array
        identifier_fields:
          description: The standard fields match.field may name
          items:
            type: string
          title: Identifier Fields
          type: array
        identifier_note:
          title: Identifier Note
          type: string
        period_note:
          title: Period Note
          type: string
        row_note:
          title: Row Note
          type: string
        snapshots:
          items:
            type: string
          title: Snapshots
          type: array
        week_starts:
          items:
            type: string
          title: Week Starts
          type: array
      required:
        - identifier_fields
        - identifier_note
        - date_formats
        - snapshots
        - week_starts
        - row_note
        - period_note
      title: ImportRules
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

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