> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Погашение людей — одиночное > Списать кредиты для получения полных контактных данных (email, телефон) конкретного человека. ## OpenAPI ````yaml ru-openapi POST /redeem/people openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Информация о профиле рабочей области и статистика использования - name: Enrichment description: Обогащение записей о людях и компаниях подробными B2B-данными - name: Lookalike description: Поиск компаний, похожих на заданную компанию - name: Search description: >- Поиск людей, компаний, вакансий, новостей и рекламы с использованием фильтров - name: Lookup description: >- Просмотр подробной информации о конкретных людях, компаниях, вакансиях, новостях, рекламе и технологиях - name: LinkedIn description: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /redeem/people: post: tags: - Redeem summary: Погашение контактных данных человека description: >- Списать кредиты для получения полных контактных данных (email, телефон) конкретного человека. operationId: redeem_people parameters: [] requestBody: required: true content: application/json: schema: type: object properties: people_search_id: $ref: '#/components/schemas/people_search_id' linkedin_url: $ref: '#/components/schemas/people_linkedin_url' people_contact_types: $ref: '#/components/schemas/people_contact_types' anyOf: - title: People Search ID required: - people_search_id - people_contact_types - title: LinkedIn URL required: - linkedin_url - people_contact_types responses: '200': description: Успешный ответ с данными погашения контактов человека. content: application/json: schema: type: object properties: data: allOf: - $ref: '#/components/schemas/data' properties: peoples: type: array description: >- Погашенные люди. Поля `emails` и `phones` равны `null` — а не `[]` — если для данного человека ничего не найдено, поэтому проверяйте это перед перебором. `total_credit_cost` учитывает только успешные совпадения и равен `0`, если ничего не было погашено; стоимость зависит от количества запрошенных типов контактов. items: type: object example: data: profile: credit: 450376 topup_credit: 235237 total_credit_cost: 45 peoples: - people_search_id: e37ccf38-ea8f-422e-9874-cb23b15e8fe4 emails: - value: example@gmail.com type: email-personal status: null - value: example@pubrio.com type: email-work status: Verified phones: - value: '+1123456789' type: phone status: null '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: people_search_id: type: string format: uuid description: Уникальный идентификатор операции поиска людей. people_linkedin_url: type: string example: http://www.linkedin.com/in/king-lai-605382b7 description: >- Полностью сформированный URL профиля пользователя в LinkedIn. URL начинается с `http` и содержит `linkedin.com/in/` или `linkedin.com/pub/` people_contact_types: type: array items: type: string enum: - email-work - email-personal - phone example: - email-work - email-personal - phone description: >- Какие контактные данные погасить. Используйте точно `email-work`, `email-personal` и/или `phone` — актуальный список можно получить из эндпоинта `people contact type` на вкладке Filters. **Нераспознанные значения не отклоняются.** Опечатка вроде `work_email` возвращает HTTP 200 с `emails: null`, `phones: null` и `total_credit_cost: 0` — точно так же, как если бы у человека действительно не было контактных данных. Если погашения выглядят повсеместно пустыми, сначала проверьте эти слаги. data: type: object nullable: true description: Информация об ответе зависит от конкретного эндпоинта. responses: general_error: description: >- Некорректный запрос. Запрос был некорректно сформирован или содержал недопустимые параметры. Подробности см. в коде и сообщении об ошибке. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````