Docs / Quotes Data API / Endpoints / List quotations

List quotations

Not served yet. The intent is that every quotation carries a source, so unsourced aphorisms are excluded rather than guessed at — but no fields are documented here, because describing the shape of data nobody has collected is how docs come to promise things the API cannot return.

GET https://api.softon.dev/v1/quotes Copy

Request

curl https://api.softon.dev/v1/quotes \
  -H "Authorization: Bearer $SOFTON_KEY"

req, _ := http.NewRequestWithContext(ctx, "GET",
    "https://api.softon.dev/v1/quotes", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("SOFTON_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer res.Body.Close()

var page struct {
    Data []Quote `json:"data"`
    Meta struct{ Next *string `json:"next"` } `json:"meta"`
}
if err := json.NewDecoder(res.Body).Decode(&page); err != nil { log.Fatal(err) }
// page.Meta.Next → send it back as ?cursor= for the following page

import json, os, urllib.parse, urllib.request

url = "https://api.softon.dev/v1/quotes"
req = urllib.request.Request(url, headers={
    "Authorization": "Bearer " + os.environ["SOFTON_KEY"],
})
page = json.load(urllib.request.urlopen(req))
# page["meta"]["next"] → send it back as ?cursor= for the following page

const url = new URL("https://api.softon.dev/v1/quotes");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.SOFTON_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
// meta.next → send it back as ?cursor= for the following page

Response

The envelope is identical on every softon.dev API: data, meta, error. Only the shape inside data changes per dataset — see the response envelope.

Nothing to show yet: this route answers 404 today, and there is no collected data to draw a sample from. When the first source lands, the example and the field table below are generated from the API's own published schema rather than written here.

Try it

Send the request to see a response.