---
title: "Approve pending sample requests by application id"
method: POST
path: "/samples/requests/approve"
tags: ["Samples"]
---

# Approve pending sample requests by application id

`POST /samples/requests/approve`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/samples/requests/approve`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Approve specific pending sample requests on TikTok, the same way the dashboard's Approve button does, including the shop's monthly sample quotas. Use it for creators that are not in the suggestion list. Creators with a pending suggestion are skipped with their suggestion id: approve those with `samples_suggestions_approve`, which applies the automation's weekly caps. Requests that are no longer pending come back in `skipped`. Sample Requests v2 shops only. Max 50 per call. Supports `X-Dry-Run: true`. Requires `read_write` scope and `Idempotency-Key`.

## Headers

- `Idempotency-Key` string, nullable
- `X-Dry-Run` string, nullable

## Request body

- SampleRequestApproveRequest
  - `application_ids` string[], required: Pending TikTok sample application ids to approve (max 50).

## Response `200`

Successful Response

- SampleRequestApproveResponse
  - `data` SampleRequestApproveResult, required
    - `approved` integer: Approved on TikTok (or would be, on a dry run).
    - `application_ids` string[]: Applications that were (or would be) approved.
    - `skipped` SampleRequestSkipped[]
      - `application_id` string, required
      - `reason` string, required
    - `failed` SampleRequestFailed[]
      - `application_id` string, required
      - `error` string, required
  - `dry_run` boolean, required

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-13** `f1e4419af264`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/samples/requests/approve/post.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)