---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.com/dev/direct/doc/en/concepts/format.md
  - https://yandex.com/dev/direct/doc/ru/concepts/format.md
  - href: https://yandex.com/dev/direct/doc/en/concepts/format.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/direct/doc/en/llms.txt?revision=r22022696
    rel: describedby
sourcePath: en/dg/concepts/format.md
title: Interaction format — Yandex Direct API
description: Requests to the Yandex Direct API over HTTPS using the POST method, HTTP headers with the OAuth token and request ID, JSON and SOAP/XML interaction formats, and UTF-8 encoding.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt?revision=r22022696


# Interaction format

Requests to the Yandex Direct API are made over the HTTPS protocol using the POST method.

A request must contain the HTTP `Authorization` header with the OAuth token of the user that the API request is being made on behalf of. It may also contain other headers that are necessary for processing the request. The response contains the `RequestId` header — the unique ID of the request.

Input and output data structures are passed in the body of the request and response. The Yandex Direct API supports two formats: [JSON](https://yandex.com/dev/direct/doc/en/concepts/json.md) and [SOAP/XML](https://yandex.com/dev/direct/doc/en/concepts/soap.md). All data is UTF-8 encoded.