# Retrieve a file

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/files/{id}:
    get:
      summary: Retrieve a file
      deprecated: false
      description: ''
      tags:
        - API Reference/Files
      parameters:
        - name: id
          in: path
          description: ''
          required: true
          schema:
            type: string
        - name: Accept
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-apifox-refs:
                  01GJ58ESJ1GBKGJKE1CMAYW25S:
                    $ref: '#/components/schemas/File'
                    x-apifox-overrides:
                      links: null
                x-apifox-orders:
                  - 01GJ58ESJ1GBKGJKE1CMAYW25S
                properties:
                  id:
                    type: string
                    description: Unique identifier for the object.
                  object:
                    type: string
                    description: '"file"'
                  created:
                    type: integer
                    description: >-
                      Time at which the object was created. Measured in seconds
                      since the Unix epoch.
                  expires_at:
                    type: integer
                    description: >-
                      The time at which the file expires and is no longer
                      available in epoch seconds.
                  filename:
                    type: string
                    description: >-
                      A filename for the file, suitable for saving to a
                      filesystem.
                  purpose:
                    type: string
                    description: 'The purpose of the uploaded file. '
                  size:
                    type: integer
                    description: The size in bytes of the file object.
                  title:
                    type: string
                    description: A user friendly title for the document.
                  type:
                    type: string
                    description: The type of the file returned.
                  url:
                    type: string
                    description: >-
                      The URL from which the file can be downloaded using your
                      live secret API key.
                x-apifox-ignore-properties:
                  - id
                  - object
                  - created
                  - expires_at
                  - filename
                  - purpose
                  - size
                  - title
                  - type
                  - url
              example:
                id: file_xxxxxxxxxxxxxx
                object: file
                created: 1668769862
                expires_at: 1692097862
                filename: file_1M5STK2EY01RxH3nPvxSLxzH
                purpose: dispute_evidence
                size: 9863
                title: null
                type: png
                url: https://files.com
          headers: {}
          x-apifox-name: OK
      security:
        - basic: []
      x-apifox-folder: API Reference/Files
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/1296482/apis/api-50223823-run
components:
  schemas:
    File:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the object.
        object:
          type: string
          description: '"file"'
        created:
          type: integer
          description: >-
            Time at which the object was created. Measured in seconds since the
            Unix epoch.
        expires_at:
          type: integer
          description: >-
            The time at which the file expires and is no longer available in
            epoch seconds.
        filename:
          type: string
          description: A filename for the file, suitable for saving to a filesystem.
        links:
          type: object
          properties:
            object:
              type: string
            data:
              type: array
              items:
                type: string
            has_more:
              type: boolean
            url:
              type: string
          required:
            - object
            - data
            - has_more
            - url
          x-apifox-orders:
            - object
            - data
            - has_more
            - url
          description: （未实现）A list of file links that point at this file.
          x-apifox-ignore-properties: []
        purpose:
          type: string
          description: 'The purpose of the uploaded file. '
        size:
          type: integer
          description: The size in bytes of the file object.
        title:
          type: string
          description: A user friendly title for the document.
        type:
          type: string
          description: The type of the file returned.
        url:
          type: string
          description: >-
            The URL from which the file can be downloaded using your live secret
            API key.
      x-apifox-orders:
        - id
        - object
        - created
        - expires_at
        - filename
        - links
        - purpose
        - size
        - title
        - type
        - url
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: https://apitest.wooshpay.com
    description: 官网测试
security:
  - basic: []

```