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

# List conversion formats

> List the external formats, such as UBL or CII, that GOBL documents can be exported to or imported from.

Use the `key` of a format with the [export](https://docs.invopop.com/api-ref/silo/gobl/convert-export.md) and [import](https://docs.invopop.com/api-ref/silo/gobl/convert-import.md) endpoints. Filter by `direction=export` to see only the formats a GOBL document can be converted to: generic formats such as `ubl` and `cii` are used to recognise documents on import, and cannot be exported to.


## OpenAPI

````yaml GET /silo/v1/gobl/convert/formats
openapi: 3.0.0
info:
  contact:
    email: dev@invopop.com
    name: Invopop Developers
  description: >-
    Store and manage GOBL documents along with their attachments in "Silo
    Entries".
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: Silo Service API
  version: 1.0.0
servers:
  - description: production
    url: https://api.invopop.com
security:
  - authToken: []
paths:
  /silo/v1/gobl/convert/formats:
    get:
      description: >-
        List the external formats, such as UBL or CII, that GOBL documents can
        be exported to or imported from.
      parameters:
        - description: Only formats that apply in the country.
          in: query
          name: country
          schema:
            description: Only formats that apply in the country.
            example: DE
            title: Country
            type: string
        - description: Only formats that convert the GOBL schema.
          in: query
          name: schema
          schema:
            description: Only formats that convert the GOBL schema.
            example: https://gobl.org/draft-0/bill/invoice
            title: Schema
            type: string
        - description: Only formats that support the conversion direction.
          in: query
          name: direction
          schema:
            description: Only formats that support the conversion direction.
            enum:
              - import
              - export
            title: Direction
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SiloFormatCollection'
          description: OK
components:
  schemas:
    SiloFormatCollection:
      properties:
        list:
          description: Conversion formats.
          items:
            $ref: '#/components/schemas/SiloFormat'
          nullable: true
          title: List
          type: array
      type: object
    SiloFormat:
      properties:
        attachments:
          description: True when exports can embed attachments.
          title: Attachments
          type: boolean
        countries:
          description: Countries the format applies in; empty for any.
          items:
            type: string
          title: Countries
          type: array
        description:
          additionalProperties:
            type: string
          description: Description of the format, by language.
          title: Description
          type: object
        export_schemas:
          description: GOBL schemas that can be exported to the format.
          items:
            type: string
          title: Export Schemas
          type: array
        import_schemas:
          description: GOBL schemas documents in the format can be imported into.
          items:
            type: string
          title: Import Schemas
          type: array
        key:
          description: Identifies the format in export and import requests.
          example: ubl+peppol+bis-v3
          title: Key
          type: string
        mime:
          description: MIME type of documents in the format.
          example: application/xml
          title: MIME
          type: string
        name:
          additionalProperties:
            type: string
          description: Name of the format, by language.
          title: Name
          type: object
        syntax:
          description: Underlying document syntax.
          example: ubl
          title: Syntax
          type: string
      type: object
  securitySchemes:
    authToken:
      bearerFormat: JWT
      description: >-
        Use the `Bearer` scheme with a valid JWT token to authenticate requests.
        Example: `Authorization: Bearer <token>`
      scheme: bearer
      type: http

````

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