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

# Get metrics

> Retrieves recorded training metrics for a fine-tuning job in chronological order. All query parameters are optional: omit them to retrieve all metrics.




## OpenAPI

````yaml GET /fine-tunes/{id}/metrics
openapi: 3.1.0
info:
  title: Together APIs
  description: The Together REST API. See https://docs.together.ai for more details.
  version: 2.0.0
  termsOfService: https://www.together.ai/terms-of-service
  contact:
    name: Together Support
    url: https://www.together.ai/contact
  license:
    name: MIT
    url: https://github.com/togethercomputer/openapi/blob/main/LICENSE
servers:
  - url: https://api.together.ai/v1
security:
  - bearerAuth: []
paths:
  /fine-tunes/{id}/metrics:
    get:
      tags:
        - Fine-tuning
      summary: Get metrics
      description: >
        Retrieves recorded training metrics for a fine-tuning job in
        chronological order. All query parameters are optional: omit them to
        retrieve all metrics.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            description: Fine-tune job ID. A string that starts with `ft-`.
            type: string
        - name: global_step_from
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: Return only metrics with global_step >= this value.
          example: 0
        - name: global_step_to
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: Return only metrics with global_step <= this value.
          example: 500
        - name: logged_at_from
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Return only metrics logged at or after this ISO-8601 timestamp.
          example: '2024-01-01T00:00:00Z'
        - name: logged_at_to
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Return only metrics logged at or before this ISO-8601 timestamp.
          example: '2024-01-01T12:00:00Z'
        - name: resolution
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: Number of (uniformly sampled) train metrics to return.
          example: 100
      responses:
        '200':
          description: List of metrics snapshots in chronological order.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metrics:
                    type: array
                    items:
                      type: object
                      additionalProperties:
                        type: number
                      description: A flat dictionary of scalar metric values.
                example:
                  metrics:
                    - train/loss: 0.5
                      train/learning_rate: 0.0001
                      train/global_step: 7
                    - train/loss: 0.45
                      train/learning_rate: 0.00009
                      train/global_step: 14
        '400':
          description: 'Invalid request: bad JSON body or missing job ID.'
        '404':
          description: Fine-tune job not found.
        '500':
          description: 'Internal server error: failed to retrieve metrics.'
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: >
            curl -X GET
            "https://api.together.ai/v1/fine-tunes/ft-id/metrics?global_step_from=0&global_step_to=500"
            \
                 -H "Authorization: Bearer $TOGETHER_API_KEY"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-bearer-format: bearer
      x-default: default

````