skills.rest
sinch
sinchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sinch-api-batch-status

Retrieve batch job status or list batches via the Sinch Conversation Batch API.

6|2|Updated Dec 11, 2025
Search Tags:#sms#oauth2#delivery tracking#message status#batch api#sinch#conversation api
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-batch-status-sinch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sinch-api-batch-status
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-batch-status
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-batch-status-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After sending bulk messages through the Sinch Conversation Batch API, you need visibility into whether those batches succeeded, failed, or are still processing. This Skill queries batch job status and delivery counts directly from the terminal without writing API client code. ## Core Features & Use Cases - Batch Status Lookup: Fetch the status of a specific batch job by ID, including sent, delivered, and failed message counts. - Batch Listing: List batches filtered by metadata key/value pairs, such as campaign tags. - Flexible Output: Render results as a readable table or structured JSON for downstream tooling. - Use Case: You launched a welcome campaign batch and want to confirm delivery rates. Run the skill with the batch ID to see per-status message counts, or list all batches tagged with metadata key "campaign" to audit recent sends. ## Quick Start Ask the assistant to check the status of batch BATCH_ID using the Sinch Batch API, or to list recent batches filtered by a metadata key and value.

Frequently Asked Questions about sinch-api-batch-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the status of a Sinch batch job?▼

Provide the batch ID and the skill issues a GET request to /v1/projects/{project_id}/messages/{batch_id} on the Sinch Conversation Batch API. It returns the batch status along with sent, delivered, and failed message counts.

How to list Sinch batches by metadata?▼

Omit the batch ID and pass a metadata key and value, such as campaign=welcome. The skill calls the list endpoint with metadataKey and metadataValue query parameters and displays matching batches with ID, status, creation time, and recipient count.

What credentials does the Sinch Batch API require?▼

The Batch API uses OAuth2 authentication and requires the CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET, and CONVERSATION_REGION environment variables. If these are missing, the skill reports that the Sinch API is not configured.

Why does my Sinch batch status request return 404 or 401?▼

A 404 means the batch ID does not exist under the given project, while a 401 indicates invalid or expired OAuth2 credentials. Verify the batch ID, project ID, region, and access key configuration, then retry the request.

Can I get Sinch batch results as JSON instead of a table?▼

Yes, pass the format option set to json. The skill then outputs the batch status or batch list as structured JSON instead of the default table, which is useful for piping into other tools or scripts.

Related Skills

Explore More Software Engineering Skills→
sinchsinch
9

sinch-conversation-api

Send and receive omnichannel messages via the Sinch Conversation API.

Official
Advanced
delta-and-betadelta-and-beta

analyst-data-export

Export Braze data from dashboard CSVs and Export API responses into analyzable datasets.

Community
Advanced
fringe4lifefringe4life

resend-inbound

Automate inbound email receipt and webhook processing with Resend's Receiving and Attachments APIs.

Community
Basic
sinchsinch
9

sinch-imported-numbers-hosting-orders

Import and manage non-Sinch US and CA numbers for SMS hosting orders.

Official
Advanced