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

# Get profile



## OpenAPI

````yaml /partners/openapi.json get /profiles/{profile_id}
openapi: 3.0.3
info:
  title: Kleep Partner API
  version: 1.0.0
  description: >-
    Size recommendations for conversational agents: customer-service agents, AI
    shopping assistants and AI agents, on behalf of Kleep retailers.
servers:
  - url: https://fit.kleep.ai/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /profiles/{profile_id}:
    get:
      summary: Get profile
      operationId: getProfile
      parameters:
        - name: Kleep-Retailer
          in: header
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The retailer's Kleep `public_id`. Every call is scoped to one
            retailer.
        - name: profile_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Profile'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: unauthorized
                  message: Invalid API key
        '403':
          description: This retailer has not enabled your integration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: retailer_not_enabled
                  message: Retailer 9b1f… has not enabled this partner
        '404':
          description: Unknown profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: profile_not_found
                  message: No profile prf_x
        '429':
          description: >-
            Rate limit reached. Retry after the number of seconds in
            `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: rate_limited
                  message: Too many requests
components:
  schemas:
    Profile:
      type: object
      required:
        - profile_id
      properties:
        profile_id:
          type: string
        measurements:
          $ref: '#/components/schemas/Measurements'
        customer_id:
          type: string
          nullable: true
        source:
          type: string
          enum:
            - conversation
            - website_questionnaire
            - body_scan
          description: Where the profile was created.
        updated_at:
          type: string
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - unauthorized
                - retailer_not_enabled
                - invalid_input
                - missing_inputs
                - product_not_found
                - product_not_supported
                - profile_not_found
                - recommendation_not_found
                - rate_limited
                - internal_error
              description: >-
                Stable, machine-readable error code. Branch on this, not on
                `message`.
            message:
              type: string
              description: >-
                Human-readable explanation, in English. Not meant to be shown to
                shoppers.
            missing:
              type: array
              items:
                type: string
              description: '`missing_inputs` only: the ids of the answers still needed.'
            questions:
              type: array
              items:
                $ref: '#/components/schemas/Question'
              description: >-
                `missing_inputs` only: the questions to ask for the missing
                answers, localized.
            details:
              type: object
              additionalProperties: true
              description: '`invalid_input` only: the offending fields.'
    Measurements:
      type: object
      description: >-
        What the shopper tells you in the conversation. Convert imperial units
        before sending.
      properties:
        gender:
          type: string
          enum:
            - female
            - male
          description: >-
            Women's or men's sizes: the cut the shopper wants, not a personal
            identity question.
        age:
          type: integer
          minimum: 12
          maximum: 100
        height_cm:
          type: number
          minimum: 120
          maximum: 230
        weight_kg:
          type: number
          minimum: 20
          maximum: 250
        body_shape:
          $ref: '#/components/schemas/BodyShape'
        bra:
          type: object
          description: Women's sizes, optional. Required only for lingerie.
          properties:
            band:
              type: string
              example: '85'
            cup:
              type: string
              example: B
            system:
              type: string
              enum:
                - EU
                - FR
                - UK
                - US
              default: EU
      example:
        gender: female
        age: 34
        height_cm: 168
        weight_kg: 61
        body_shape:
          stomach: medium
          hips: wide
    Question:
      type: object
      required:
        - id
        - required
        - type
        - prompt
      properties:
        id:
          type: string
          description: >-
            Path of the answer in `measurements`, for example `height_cm` or
            `body_shape.hips`.
        required:
          type: boolean
        type:
          type: string
          enum:
            - choice
            - number
            - integer
            - text
        prompt:
          type: string
          description: >-
            Ready-to-ask wording in the requested locale. Rephrase freely to
            match your bot's tone.
        unit:
          type: string
          enum:
            - cm
            - kg
        min:
          type: number
        max:
          type: number
        default:
          type: string
          description: Value Kleep assumes when an optional question is skipped.
        options:
          type: array
          items:
            type: object
            properties:
              value:
                type: string
              label:
                type: string
    BodyShape:
      type: object
      description: >-
        Optional body-shape answers. Each one improves accuracy; skip any the
        shopper doesn't want to answer.
      properties:
        stomach:
          type: string
          enum:
            - flat
            - medium
            - round
        hips:
          type: string
          enum:
            - narrow
            - medium
            - wide
          description: Women's sizes.
        torso:
          type: string
          enum:
            - slim
            - medium
            - muscular
          description: Men's sizes.
        thighs:
          type: string
          enum:
            - thin
            - medium
            - large
          description: Men's sizes.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your partner API key: `kp_live_…` in production, `kp_test_…` on the
        sandbox retailer.

````

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