Skip to content

An item​

GET
/free-stuff/{id}

One item for this viewer: photos, title, condition, area and distance band, pickup methods, available until, and the giver's first name with "gave N things" (or the provider's name and kind). Signed in, the viewer's own ask and what stops them asking. The giver also gets the asks, why it is held and staff's decision; the person chosen gets the pickup place and note while chosen. Nobody else ever gets the pickup. A closed item answers 410 to anyone who did not ask for it; a held one is the giver's alone (404). A person the giver blocked gets 410.

Authorizations​

or
BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type
HTTP (bearer)

Parameters​

Path Parameters

id*

The item.

Type
string
Required
Format
"uuid"

Query Parameters

near

lat,lng of the browser, for the distance band.

Type
string

Responses​

The item.

application/json
JSON
"string"

Playground​

Server
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI

Built with VitePress