📖 Finnting API

REST + JSON. Push your whole portfolio automatically.

Authentication

Create a token in the business centre and send it as a Bearer token. The token decides which business the listings are attached to.

Authorization: Bearer ft_live_…

Endpoints

`PUT`	`/api/v1/listings/{external_id}` — create/update (upsert). Deduped on (business, external_id).
`GET`	`/api/v1/listings` — list the business's listings (filters: `vertical`, `status`, `limit`, `offset`).
`GET`	`/api/v1/listings/{external_id}` — fetch one listing.
`DELETE`	`/api/v1/listings/{external_id}` — withdraw (status = withdrawn).
`POST`	`/api/v1/listings/{external_id}/sold` — mark as sold.

external_id is your own ID for the object (analogous to IADIF ORDERNO). It is unique per business, so two businesses can both use «123» without conflict. The response returns Finnting's id and the public URL.

Example — upsert a car

curl -X PUT https://finnting.no/api/v1/listings/DLR-7781 \
  -H "Authorization: Bearer ft_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "vertical": "car",
    "title": "Volvo XC60 B4 AWD Inscription",
    "description": "Velholdt, full servicehistorikk.",
    "price": 459000,
    "location": "Stavanger",
    "attrs": {
      "make": "Volvo", "model": "XC60", "year": 2021,
      "km": 58000, "fuel": "Hybrid", "gearbox": "Automat",
      "power": 197, "body": "SUV", "color": "Sort"
    }
  }'

Verticals: car · property · boat · generic. The attribute keys are the same as in the Finnting form for each vertical.

Response

{
  "operation": "created",
  "id": 4821,
  "external_id": "DLR-7781",
  "vertical": "car",
  "status": "active",
  "org_id": 12,
  "url": "https://finnting.no/annonse/Kp7mQ2xT9b/volvo-xc60-b4-awd-inscription",
  "warnings": []
}