API Report a Problem Resource

Submits a problem report for a given instrument and optionally notifies you when the problem is resolved via email or webhook. We check these reports regularly and work with the county to resolve issues with scanning or indexing.

Address

https://okcountyrecords.com/api/v1/report-a-problem

Parameters

Name	Description
county	Required. A county name.
book	Required. A book number.
beginning_page	Required. The number of the first page of the problem instrument.
description	A description of the problem you found.
incorrect_legal_description	Providing 1 indicates that you found a problem with the legal description. You must indicate at least one problem in your request.
incorrect_images	Providing 1 indicates that you found a problem with the images.
incorrect_instrument_type	Providing 1 indicates that you found a problem with the instrument type.
incorrect_parties	Providing 1 indicates that you found a problem with the parties.
return_email	If specified, this address will get an email when the problem is resolved.
return_webhook	If specified, this URL will be hit when the problem is resolved. Read more below.

Example Request


https://okcountyrecords.com/api/v1/report-a-problem

?county=Adair&book=293&beginning_page=737&incorrect_images=1

&return_email=john.doe@someservice.com

&return_webhook=http://mysite.com/problem-resolution

{
	"success": true
}

Webhooks

Once the problem has been resolved, the URL you provide will get a POST request once every hour for 24 hours until we get a 200 response code. You can use the Problem Reports resource to catch up on what you miss. The POST body of our request will be in the following format:

{
	"county": "Adair",
	"book": "000293",
	"beginning_page": "0737",
	"resolution": "manually-fixed"
}

Here is the list of possible resolutions:

automatic-repull (We repulled the instrument automatically and it may have fixed the problem.)
manually-fixed
talk-to-clerk (You will need to contact the county clerk's office directly.)
kellpro-notified-clerk
no-issue (We couldn't find a problem with the instrument.)
clerk-files-that-way
pdf-viewer (This should rarely be the resolution of a problem reported through the API.)
external-response (We contacted you about this one directly.)
no-response (No response was necessary for this resolution.)