Answers and errors

The shape of every answer, what a notice means, and what an error carries.

An answer

Every answer

{
  "data": …,
  "asOf": "…",
  "notice": "…"
}

data is what you asked for; each endpoint’s page shows an abridged example.
asOf is the moment the answer was made, as an ISO timestamp.
notice appears when the answer quotes text written outside WiseView — headlines, filings, transcripts — so a script that hands it to an AI can say it is quoted material, not instructions.

Every error

{
  "error": {
    "code": "…",
    "message": "…"
  }
}

The code is stable — branch on it. The message is a plain sentence you can show a person.

Every code the API answers with, generated from the API itself:

Status	Code	When
400	`invalid_params`	A parameter is unknown, missing, given twice or out of range. The message names it.
400	`key_in_address`	A key was put in the address. Send it in the Authorization header instead.
401	`missing_key`	No key was sent. Send "Authorization: Bearer wv_live_…".
401	`invalid_key`	The key is not one of ours. Check it was copied whole.
401	`key_revoked`	The key was revoked. Make a new one in your account, under API.
403	`switched_off`	The API is switched off right now.
403	`blocked`	The API is turned off for this account.
403	`account_closed`	This account cannot be used right now.
403	`membership_required`	The account has no active membership.
403	`not_on_plan`	The account's plan does not include the API. The free plan has no keys.
403	`endpoint_off`	This endpoint, or the feature behind it (like the squawk), is switched off right now.
403	`members_only`	The account's plan does not include this endpoint's data.
404	`not_found`	The lookup found nothing (an unknown report id, a name with no trades), or there is no endpoint at this address. Not counted.
405	`method_not_allowed`	Anything but GET. The API is read-only.
429	`rate_limited`	Too many calls this minute. Wait a moment.
429	`allowance_used_up`	This month's calls (or a trial's) are used up. Carries refillsAt and trialEndsAt.
500	`server_error`	Something went wrong on our side. Try again in a moment.
502	`lookup_failed`	The lookup failed on our side. Not counted; try again shortly.

Only GET is answered: the API reads, and changes nothing in your account.