Orders

Place an order

Charges your balance and starts delivery. Send an Idempotency-Key header so a retry never double-charges. With dry_run: true nothing is charged: you get the price, your balance and whether it is enough.

post/api/v1/orders

Request

  • Base URL: https://spoofy.social
  • URL: https://spoofy.social/api/v1/orders
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token

Headers

Idempotency-Keystring

Any unique string (≤ 120 chars) per intended order. Retrying with the same key returns the first order instead of charging twice.

Request body

serviceinteger required
linkstring required
quantityinteger

How many. Left out where the inputs count it (comments, usernames) or it is fixed (packages, subscriptions); per run when spread over runs.

dry_runboolean
detailsobject

Done-for-you services only: the answers to the service’s form (key → text; image fields → upload id).

Response

Dry run answer — or a replay of an earlier order with the same Idempotency-Key (replayed: true).

dry_rununknown
balancestring

Your balance. USD as a decimal string.

sufficientboolean
text_reviewboolean

Our team may check the text before the order starts (it is placed and charged, then waits).

Changes

No recorded changes to this operation across all 1 revision of this API.