API

This website has a JSON API which you can use to remotely retrieve data on reports of trans people lost to violence in its many forms.

This can be used to construct data visualisation and analysis implementations such as (for example) those produced by members of the R Foundation for Transgender Day of Remembrance 2018 (see https://github.com/rlgbtq/TDoR2018 and https://github.com/CaRdiffR/tdor).

This page allows you to run sample queries on the API, and examine the responses that result. To use it you will need an API key, which you can obtain by registering an account and logging in.

If you are not logged in and already have an API key, you can enter it below:

API key:

We hope that the format of the responses will prove to be self-explanatory. If you have any queries, please feel free to contact tdor@translivesmatter.info or @TDoRinfo.

 

Getting summary data on multiple reports

To retrieve summary data for multiple reports, enter some parameters to guide your search, for example the dates, country or an arbitrary filter string:

From Date:
To Date:
Country:
Category:
Filter:
Query URL:
https://tdor.translivesmatter.info/api/v1/reports?key=<api-key>&from=<date>&to=<date>&country=<country>&filter=<filter>


Response:

 

Getting detailed data on a specific report

To retrieve detailed data (including a full description) for a specific report, enter either its URL (e.g. https://tdor.translivesmatter.info/reports/2012/03/20/jose-carlos-de-almeida_teresina-piaui-brazil_8442ac9b) or UID (the 8 digit hex string at the end of the URL - 8442ac9b in this particular case):

URL:
UID:
Query URL:
https://tdor.translivesmatter.info/api/v1/reports?key=<api-key>&url=<url>&uid=<uid>


Response:

Trigger warning

This site contains reports of violence against transgender people, and links to detailed reports which contain graphic imagery.

Please continue with caution.

Continue

Get me out of here!