The request is valid but clashes with the current state — a duplicate, a seat already taken, a state transition that is not allowed from here.
Defined in RFC 9110 §15.5.10 — 409 Conflict · MDN reference
Double-booked seats, duplicate usernames, deleting a record that something else still points at, cancelling an order that already shipped, and any state machine asked to make a transition it does not have.
A 409 is a state problem, not a transport problem, so blind retries make it worse. Test that your retry policy distinguishes it from a 503.
A 409 is about state, so a blind retry usually fails identically — the seat is still taken. Re-read the current state, decide whether the operation still makes sense, and only then try again. This is the status where an automatic retry policy does the most damage for the least benefit.
76 endpoints in this playground answer with 409. Every one is free, needs no signup, and can be called from the browser or with curl.
DELETE https://funapi.dev/api/pizza/v1/orders/{id} — Cancel an order (409 if already delivered) (Pizza Orders API) Open & run this endpointPUT https://funapi.dev/api/coffee/v1/orders/{id}/ready — Mark an order ready (409 if already ready) (Coffee Shop API) Open & run this endpointDELETE https://funapi.dev/api/football/v1/teams/{id} — Remove a team (409 if it has played matches) (Football API) Open & run this endpointPATCH https://funapi.dev/api/holmes/v1/cases/{id} — Update a case status (409 if unchanged) (Sherlock Holmes API) Open & run this endpointPOST https://funapi.dev/api/webhooks/v1/deliveries/{id}/replay — Replay a delivery attempt — re-sends the real HTTP POST (409 after 3 attempts) (Webhooks API) Open & run this endpointPOST https://funapi.dev/api/webhooks/v1/ordering — Generate duplicate and reversed envelopes without making outbound requests (Webhooks API) Open & run this endpointPOST https://funapi.dev/api/dinopark/v1/dinosaurs — Add a dinosaur (409 if enclosure is at capacity) (Dino Park API) Open & run this endpointPOST https://funapi.dev/api/marvel/v1/missions/{id}/complete — Mark a mission complete (409 if already complete) (Marvel API) Open & run this endpointPOST https://funapi.dev/api/got/v1/nobles/{id}/kill — Kill off a noble (409 if already dead) (Game of Thrones API) Open & run this endpointPOST https://funapi.dev/api/got/v1/battles — Simulate a battle between two houses (Game of Thrones API) Open & run this endpointPOST https://funapi.dev/api/bank/v1/transfers — Transfer money between accounts (Bank API) Open & run this endpointPOST https://funapi.dev/api/bank/v1/accounts/{id}/freeze — Freeze an account (admin only) (Bank API) Open & run this endpointPOST https://funapi.dev/api/airline/v1/bookings — Book a seat (409 on conflicts & overbooking) (Airline API) Open & run this endpointPUT https://funapi.dev/api/airline/v1/bookings/{id}/seat — Change seat (If-Match concurrency) (Airline API) Open & run this endpointPOST https://funapi.dev/api/airline/v1/bookings/{id}/checkin — Check in (state machine) (Airline API) Open & run this endpointDELETE https://funapi.dev/api/airline/v1/bookings/{id} — Cancel a booking (admin only, then 410) (Airline API) Open & run this endpointPATCH https://funapi.dev/api/protocol/v1/documents/{id} — RFC 6902 JSON Patch (op/path/value) (Protocol Lab API) Open & run this endpointPOST https://funapi.dev/api/shop/v1/carts/{id}/items — Add a product (409 when out of stock) (Shop API) Open & run this endpointPOST https://funapi.dev/api/shop/v1/carts/{id}/checkout — Check out (idempotent, coupon-aware) (Shop API) Open & run this endpointPOST https://funapi.dev/api/shop/v1/reservations — Hold stock without overselling (Shop API) Open & run this endpointGET https://funapi.dev/api/shop/v1/reservations/{id} — Observe stock reservation expiry (Shop API) Open & run this endpointPOST https://funapi.dev/api/shop/v1/reservations/{id}/confirm — Consume reserved stock using its version (Shop API) Open & run this endpointPOST https://funapi.dev/api/cargo/v1/shipments/{id}/advance — Advance the state machine one step (X-API-Key) (Cargo Tracking API) Open & run this endpointPOST https://funapi.dev/api/cargo/v1/shipments/{id}/attempt-delivery — Attempt delivery — may fail, 3 strikes returns it (X-API-Key) (Cargo Tracking API) Open & run this endpointPUT https://funapi.dev/api/cargo/v1/shipments/{id}/address — Redirect a parcel (X-API-Key + If-Match) (Cargo Tracking API) Open & run this endpoint…and 51 more endpoints across the catalog.
All HTTP status codes · All 55 mock REST APIs · Getting started guide
Last updated