OBV API

This API, and the database it connects to are works in progress. The API began as a way to provide web access to data collected for the Old Bailey Voices of Authority project for a VR puppet show, this is still the primary purpose. The desire for more data to increase the story telling possibilities means the dabase and API continue to grow. The database now includes sources from the Old Bailey Online and the Old Bailey Corpus (2). The work that created these data sets represents considerable effort that has taken place over more than two decades. This project is entirely dependent on the source data and the work that created it.

The work is an output the Sussex Humanities Lab at the University of Sussex. If you find the API useful it was written by Ben Jackson with assistance from Tim Hitchcock. If you wish to create applications based on it please contact me (find me on the Sussex Uni web pages) - this access point is my development site and is likely to change without notice, this site is where I try out ideas so changes may occur while you're reading. Please contact me if you want more reliabale use of the work.

Catagories

obo = information taken from Old Bailey Online ~ (1674 - 1913)
obc = information taken from Old Bailey Corpus (2) ~ (1720 - 1913)
obv = information taken from Old Bailey Voices of Authority ~ (1720 - 1880)

get_obc_producer/..... Returns an obc producer entry
get_obv_trialid/defendant/t17800112-1-defend47/format/json Returns a trial from a defendantid -
get_obv_session_list/..... Returns a list (227) of obv session dates -
get_obv_session_trial_list/..... Returns a list of trial IDs, uses an obv session date to specify the session paper
get_obv_trials_wordcounts/..... Returns a list of trial wordcounts, ids and session dates.
get_obv_trials_more/..... Returns a list of trial wordcounts, ids and session dates + lots more - I plan to use this to set up selection filters. Populate the results area (below) with an example render of the response.
get_obv_defendant_list/..... Returns a list of obo defendant ids - this was the first test example for the OBV API, (so may never be useful). This call is likely to disappear – This data (and more) can be accessed using the get_obv_trial call. Populate the results area (below) with an example render of the response.
get_obv_defendant_list_all Returns a list of obo defendant ids (from OBV data) including names and gender. Populate the results area (below) with an example render of the response.
get_obv_trial/trial/..... Call returns a (complete) row from the obv_defendants_trials table. Field names reflect table row headers used in the OBV data source. Trial specified by the "trial" segment of the url, which is the obo_trial value. Date range: 1780-01-12 to 1880-012-13 20932 records Populate the results area (below) with an example render of the response.
get_obv_trial_id_list/..... Call returns a list of trial ids (content of the obo_trial field from the obv_defendants_trials table). Date range: 1780-01-12 to 1880-012-13 20932 records Populate the results area (below) with an example render of the response.
get_obv_words_by_trial/trial... Call returns an array of rows from the obv_words table containing the set of speech events for a single trial. Trial specified by the "trial" segment of the url, which is the obo_trial value. Date range: 1780-01-12 to 1880-012-13 321575 records Populate the results area (below) with an example render of the response. Populate the results area (below) with an example render of the timeline render. seperate example render of the timeline render. (press the many timelines button)
get_random_obv_trial... Call returns a random row from the obv_defendants_trials table. Field names reflect table row headers used in the OBV data source. Date range: 1780-01-12 to 1880-012-13 20932 records Populate the results area (below) with an example render of the response.
get_random_trial_from_obv... Call returns a random row from the obv_words table. Field names reflect table row headers used in the OBV data source. - These trial have been tagged with speakers Date range: 1780-01-12 to 1880-012-13 20932 records Populate the results area (below) with an example render of the response.
get_obc_sessions_link/sess_date/... Call returns a link to an obc2 transcription Date range: 1720-04-27 to 1913-03-04 637 records Populate the results area (below) with an example render Use the result to populate the results area (below) with an example render that uss the result to access the xml resource. Use the result to populate the results area (below) with an example render that uss the result to access the json resource.
get_obc_sessions_pos_link/sess_date/... Call returns a link to a parts of speech (POS) tagged obc2 transcription Date range: 1720-04-27 to 1913-03-04 637 records Populate the results area (below) with an example render Use xml path to access the resource and render the result (below). Use json path to access the resource and render the result (below).
get_obo_trials_wordcounts/... Call obo wt word counts Date range: 1674-07-04 to 1913-04-01 197041 records
get_obo_trials_summaries/... Call obo wt word counts Date range: 1674-07-04 to 1913-04-01 197673 records
get_obo_sessions_papers/sess_date/... Call returns a link to an obo session paper Date range: 1674-07-04 to 1913-04-01 2149 records Populate the results area (below) with an example render Use the result to populate the results area (below) with an example render that uses the result to access the xml resource.
get_obo_ordinarys_accounts/sess_date/... Call returns a link to an obo ordinary paper Date range: 1676-05-17 to 1722-10-14 468 records Populate the results area (below) with an example render Use the result to populate the results area (below) with an example render that uses the result to access the xml resource.
get_obo_crime_location/trial/... Call returns an OBO crime location for a specified trial - not all trials have this field *(to do: some, return null for emptys)* Date range: 1674-04-29 to 1834-10-16 55620 records Populate the results area (below) with an example render
get_obo_defendant_home/trial/... Call returns the OBO defendant home for a specified trial - not all trials have this field *(to do: some, return null for emptys)* Date range: 1675-01-15 to 1811-05-29 12031 records Populate the results area (below) with an example render
get_obc_session_description/sess_date/... Call returns a link to a json file containing data from the session paper title, judiciary, juries[middlesex_jury, london_jury], adverts, date, trials, criminal_charges[defendant:id offence cat desc verdict witnesses punishments id victims defendants ], Date range: 1720-04-27 to 1913-03-04 637 records Populate the results area (below) with an example render Use json path to access the resource and render the result (below). Title Judiciary Juries Adverts OffenceDesc

trial id setting = t17800112-1
Note!: This input sets the trial id variable used in calls that need a "trial" url segment. Trial id selects against the contents of the obo_trial column, so must be valid . (Hint: trial id list gets a list of trial ids, use one to set this field)
sess_date setting = 17800112
Note!: This input sets the sess_date variable used in calls that need the url segment. sess_date selects against the contents of the sess_date column in the obc2 table, so must be valid.

Results

(SHL) Old Bailey Voices API

OBV API