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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Gönderiler API'si

> Gönderi, bir ödemeye kargo takip numarası ekler ve paketi etiket oluşturulmasından teslimata kadar izleyerek mevcut teslimat durumunu ve müşteriye yönelik bir takip URL'sini sunar.

Gönderiler API'sini bir hesabın gönderilerini listelemek, bir gönderiyi kimliğine veya karşıladığı ödemeye göre almak, bir ödemeye takip numarası eklemek ve mevcut bir gönderideki takip numarasını güncellemek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Gönderileri Listele](https://docs.whop.com/tr/api-reference/shipments/list-shipments.md) | GET `/shipments` |
| [Gönderiyi Al](https://docs.whop.com/tr/api-reference/shipments/retrieve-shipment.md) | GET `/shipments/{id}` |
| [Gönderi Oluştur](https://docs.whop.com/tr/api-reference/shipments/create-shipment.md) | POST `/shipments` |
| [Gönderiyi Sorgula](https://docs.whop.com/tr/api-reference/shipments/look-up-shipment.md) | POST `/shipments/lookup` |
| [Gönderiyi Güncelle](https://docs.whop.com/tr/api-reference/shipments/update-shipment.md) | PATCH `/shipments/{id}` |

## Öznitelikler

**id** `string` *required*

`ship_` önekli gönderi kimliği.

**account\_id** `string` *required*

Bu gönderinin sahibi olan `biz_` önekli hesap.

**carrier** `string | null` *required*

Bu gönderi için algılanan kargo firması. Bir takip güncellemesi onu
belirleyene kadar null.

**checkpoints** `object[]` *required*

Bu gönderinin kargo firması tarama geçmişi, en eski tarama önce. Kargo firması ilk taramasını bildirene kadar boştur.

> [accordion] Özellikler
>
> **location** `string | null` *required*
>
> Kargo firmasının taramayı kaydettiği yer, örneğin `PHILADELPHIA, PA`. Kargo
> firması bir yer göndermediğinde null.
>
> **message** `string | null` *required*
>
> Kargo firmasının taramaya ilişkin açıklaması, örneğin `Departed USPS Regional Facility`.
> Kargo firması bir açıklama göndermediğinde null.
>
> **status** `string` *required*
>
> Bu kargo taramasının karşılık geldiği teslimat durumu.
>
> Kullanılabilir seçenekler: `unknown`, `pre_transit`, `in_transit`, `out_for_delivery`, `delivered`, `available_for_pickup`, `return_to_sender`, `failure`, `cancelled`, `error`
>
> **timestamp** `string | null` *required*
>
> Kargo firmasının taramayı kaydettiği zaman, ISO 8601 zaman damgası olarak. Kargo firması tarama zamanı göndermediğinde null.

**created\_at** `string` *required*

Gönderinin oluşturulduğu tarih ve saat (ISO 8601).

**payment\_id** `string` *required*

Bu gönderinin karşıladığı `pay_` önekli ödeme.

**status** `string` *required*

Bu gönderinin mevcut teslimat durumu.

Kullanılabilir seçenekler: `unknown`, `pre_transit`, `in_transit`, `out_for_delivery`, `delivered`, `available_for_pickup`, `return_to_sender`, `failure`, `cancelled`, `error`

**tracking\_number** `string` *required*

Gönderinin ilerleyişini sorgulamak için kullanılan, kargo firmasının atadığı takip numarası.

**tracking\_url** `string` *required*

Bu gönderinin ilerleyişini takip etmek için müşteriye yönelik bir URL.

**updated\_at** `string` *required*

Gönderinin en son güncellendiği tarih ve saat (ISO 8601).

```json Shipment theme={null}
{
	"id": "ship_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"payment_id": "pay_xxxxxxxxxxxxxx",
	"carrier": "ups",
	"tracking_number": "1Z999AA10123456784",
	"tracking_url": "https://track.aftership.com/xxxxxxxxxxxxxxxxxx",
	"status": "in_transit",
	"checkpoints": [
		{
			"status": "in_transit",
			"message": "Picked up",
			"location": "PHILADELPHIA, PA",
			"timestamp": "2026-09-15T16:42:00.000Z"
		}
	],
	"created_at": "2026-09-15T14:30:00.000Z",
	"updated_at": "2026-09-15T16:45:10.000Z"
}
```


## Related topics

- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
