List your Proof of Work jobs
Returns your page's Proof of Work jobs, newest first: the kind of work, the month, how many photos, and whether a customer's review confirmed it. Free on every level, with the same limits everywhere.
Scope: reviews:read · Plan: Growth, Pro and Enterprise in live mode (any Reviews level for an Agoo Reviews key); every plan in test mode.
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
agoo_rk_live_ | Agoo Reviews key, live mode: a business on Agoo Reviews on its own, on Reviews Business | Your servers only: the Reviews operations, for that business and the branches the key names |
agoo_rk_test_ | Agoo Reviews key, test mode | As above, on any level: it reads the business's reviews and checks every write without saving it |
agoo_ck_live_ | Check API key, live mode, for a Check API partner | Your servers only: the Checks operations (checks:read), billed per check |
agoo_ck_test_ | Check API key, test mode | As above, answering only the published test values, never billed |
Admins create keys in Console → Developers → API keys and choose each key's scopes; a business on Agoo Reviews on its own creates its keys in its business area on agoo.reviews, under Developers; a Check API partner creates its keys in its partner area on agoo.reviews. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: reviews:read
limit?integerHow many items to return, from 1 to 100.
1 <= value <= 10025cursor?stringThe next_cursor from the previous page. Leave it out for the first page.
length <= 512confirmed?booleanOnly jobs a customer confirmed (true) or not yet (false).
A page of jobs.
application/json- response
data*array<>next_cursor*|Pass this as cursor to get the next page. null on the last page.
"b3BhcXVlLWN1cnNvcg"has_more*booleancurl -X GET 'https://api.agoohq.com/v1/review-jobs?limit=25'{ "data": [ { "id": "string", "object": "review_job", "business_id": "string", "work_kind": "string", "title": "string", "town": "string", "month": "string", "status": "screening", "confirmed": true, "confirmed_at": "2019-08-24T14:15:22Z", "review_id": "string", "photos": 0, "created": "2019-08-24T14:15:22Z" } ], "next_cursor": "b3BhcXVlLWN1cnNvcg", "has_more": true}Add to your Fix Log POST
Adds a fix: what you changed, the day it was fixed, and up to three things reviews mention that it answers (chips or insight topics). It's checked before it shows; one that names a person or gives contact details waits for a moderator. It can be added to but never rewritten after seven days, and it never moves your score or your place in any order. Three a week at most. `review_fix.published` fires when it shows. A test key checks it and writes nothing. **Scope:** `reviews:write` · **Plan:** Growth, Pro and Enterprise in live mode (any Reviews level for an Agoo Reviews key); every plan in test mode.
List Complaint Register exports GET
Returns your Complaint Register's exports, newest first: each month's, made by itself, and any range you asked for, with its state and the files made. Download the files in the business area, signed in. Needs the Complaint Register: an add-on to Reviews Business, and part of Reviews Enterprise. **Scope:** `reviews:read` · **Plan:** Growth and Pro with the Complaint Register, and Enterprise, in live mode (Reviews Business with the add-on or Reviews Enterprise for an Agoo Reviews key).