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

# Начать проверку

> Создаёт новую проверку доставляемости. Возвращает уникальный `check_id` и список тестовых адресов, на которые нужно отправить письмо.

Каждый адрес содержит тег `+tc_{check_id}` — он используется для привязки вашего письма к проверке. Отправьте **одно письмо** на все адреса из массива `accounts`.



## OpenAPI

````yaml /openapi.json post /api/spam-check/start
openapi: 3.1.0
info:
  title: Taimly Spam Check API
  version: 1.0.0
  description: >-
    API для проверки доставляемости email. Определяет, куда попадает ваше
    письмо: во Входящие, Спам, Промоакции или другие категории Gmail.
servers:
  - url: https://taimly.net
    description: Production
security:
  - BearerAuth: []
paths:
  /api/spam-check/start:
    post:
      tags:
        - Spam Check
      summary: Начать проверку
      description: >-
        Создаёт новую проверку доставляемости. Возвращает уникальный `check_id`
        и список тестовых адресов, на которые нужно отправить письмо.


        Каждый адрес содержит тег `+tc_{check_id}` — он используется для
        привязки вашего письма к проверке. Отправьте **одно письмо** на все
        адреса из массива `accounts`.
      operationId: startSpamCheck
      responses:
        '200':
          description: Проверка создана
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpamCheckStartResponse'
              example:
                check_id: a1b2c3d4e5f6
                accounts:
                  - inbox1+tc_a1b2c3d4e5f6@gmail.com
                  - inbox2+tc_a1b2c3d4e5f6@gmail.com
                  - inbox3+tc_a1b2c3d4e5f6@gmail.com
        '401':
          description: Невалидный или отсутствующий API-ключ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Invalid or missing API key
        '404':
          description: Нет доступных тестовых аккаунтов
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: No accounts available for this scope
components:
  schemas:
    SpamCheckStartResponse:
      type: object
      required:
        - check_id
        - accounts
      properties:
        check_id:
          type: string
          description: Уникальный идентификатор проверки
          example: a1b2c3d4e5f6
        accounts:
          type: array
          description: Список тестовых адресов для отправки письма
          items:
            type: string
            format: email
          example:
            - inbox1+tc_a1b2c3d4e5f6@gmail.com
            - inbox2+tc_a1b2c3d4e5f6@gmail.com
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Описание ошибки
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API-ключ. Передаётся в заголовке `Authorization: Bearer <ваш_ключ>`.
        Ключ выдаётся администратором Taimly.

````