API documentation

Authentication

Send your token in the Authorization header:

Authorization: Bearer sc_your_token_here

Base URL

https://one.snipcash.com/api/v1

All endpoints accept and return JSON. Internal FastAPI↔Laravel calls use /api/internal/* with a service key.

Create a short link

POST /api/v1/links
Content-Type: application/json

{
  "destination_url": "https://example.com/offer",
  "alias": "spring-sale",
  "redirect_type": "timer",
  "title": "Spring campaign"
}

List links

GET /api/v1/links?page=1

Get a link

GET /api/v1/links/{id}

Update a link

All fields are optional — send only what you want to change. status accepts active or paused.

PATCH /api/v1/links/{id}
Content-Type: application/json

{
  "destination_url": "https://example.com/new-offer",
  "title": "Updated campaign",
  "status": "paused"
}

Delete a link

The short link stops resolving immediately.

DELETE /api/v1/links/{id}

Redirect resolve (internal)

Used by the FastAPI redirect service — not for public clients.

GET /api/internal/links/{slug}
Header: X-SnipCash-Key: {internal_key}