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

# Get reporting traits

> Returns all available reporting/demographic breakdown traits that can be applied to surveys. These traits allow you to segment survey results by demographics such as age, gender, income, and more.

Optionally filter by country code to see traits available in a specific market.



## OpenAPI

````yaml /api-reference/openapi.json get /traits/reporting
openapi: 3.1.0
info:
  title: PickFu API
  version: 1.0.0
  description: >-
    The PickFu API enables programmatic access to create surveys, retrieve
    results, and integrate PickFu into your workflows.


    ## Overview


    PickFu helps you get instant consumer feedback through surveys. With the
    API, you can:


    - Create surveys programmatically

    - Retrieve survey results and respondent data

    - Target specific audiences with demographic traits

    - Integrate PickFu into your product development workflow


    ## Rate Limits


    Selected endpoints (currently the CSV export endpoints) enforce per-caller
    rate limits and return `429 Too Many Requests` when exceeded. See each
    endpoint description for its specific budget.


    ## Authentication


    All API requests require a Bearer token — either an API key or an OAuth 2.0
    access token. See the [Authentication
    guide](https://www.pickfu.com/docs/developers/authentication) for details.
  contact:
    name: PickFu Support
    email: support@pickfu.com
    url: https://www.pickfu.com
servers:
  - url: https://api.pickfu.com/v1
    description: Production
  - url: https://api.pickfu-sandbox.com/v1
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Surveys
    description: >-
      Create, retrieve, update, and publish surveys. Surveys are the core
      resource — each contains one or more questions with answer options.
  - name: Responses
    description: >-
      Retrieve individual responses (answers) for a survey, with pagination and
      per-question filtering.
  - name: Tags
    description: Organize surveys with tags. Tags are scoped to your team/account.
  - name: Projects
    description: >-
      Organize surveys into projects. Projects group related surveys and can be
      bookmarked or archived.
  - name: Traits
    description: >-
      Audience targeting and reporting traits used to reach specific
      demographics and segment survey results.
  - name: Playbooks
    description: >-
      Discover and retrieve step-by-step research playbooks. Each playbook is a
      structured sequence of polls designed for a specific research goal.
  - name: Help
    description: Search the PickFu help center for articles and guides.
  - name: Media
    description: >-
      Generate images from text prompts and upload media files to the PickFu
      CDN.
paths:
  /traits/reporting:
    get:
      tags:
        - Traits
      summary: Get reporting traits
      description: >-
        Returns all available reporting/demographic breakdown traits that can be
        applied to surveys. These traits allow you to segment survey results by
        demographics such as age, gender, income, and more.


        Optionally filter by country code to see traits available in a specific
        market.
      operationId: getReportingTraits
      parameters:
        - schema:
            type: string
          in: query
          name: country
          required: false
          description: >-
            Two-letter country code to filter available traits (e.g. US, GB).
            Defaults to US traits when omitted.
      responses:
        '200':
          description: List of available reporting traits
          content:
            application/json:
              schema:
                type: array
                description: List of available reporting traits
                items:
                  type: object
                  required:
                    - trait_name
                    - permalink
                  properties:
                    trait_name:
                      type: string
                      description: 'Human-readable trait name (e.g. "Age: 25-34")'
                    permalink:
                      type: string
                      description: >-
                        Trait permalink to use in the reporting array when
                        creating or updating surveys
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        OAuth2 access token obtained via the authorization flow. Include in the
        Authorization header as: `Bearer {access_token}`

````