The endpoint for Official & Staffer roles (periods of time in a specific office / job).
Retrieve multiple Roles based on search critera passed as GET Arguments
get/api/newpersonrole/
The endpoint for Official & Staffer roles (periods of time in a specific office / job).
Securityapi_key and user_name
Request
query Parameters
current
boolean
Whether this PersonRole is currently applicable/currently held. Should be completely redundant given startdate and enddate.
district
integer <int64>
For representatives, the number of their congressional district. 0 for at-large districts.
NOTE: Parameter accepts additional qualifiers appended to the end: district__in - The value for the record is in the provided array parameter (comma-separated values). district__gt, district__gte, district__lt, district__lte - The value for the record is greater than/less than (or equal to) the provided parameter. district__isnull - The value for the record is null (if true) or is not null.
district_obj_id
integer <int64>
The district with which this personrole is associated.
NOTE: Parameter accepts additional qualifiers appended to the end: district_obj__in - The value for the record is in the provided array parameter (comma-separated values). district_obj__isnull - The value for the record is null (if true) or is not null.
electcode
integer <int64>
How the person was elected to congress
NOTE: Parameter accepts additional qualifiers appended to the end: electcode__in - The value for the record is in the provided array parameter (comma-separated values). electcode__isnull - The value for the record is null (if true) or is not null.
See the Enumeration Documentation CSV file located at Quorum_API_Enumeration_Values.csv, name ElectCode, for an explanation of values.
Enum:12345
enddate
string <date-time>
The date the role ended (when the person resigned, died, etc.)
NOTE: Parameter accepts additional qualifiers appended to the end: enddate__year, enddate__month, enddate__day - The value for the record matches the provided year/month/day (note that week_day, hour, minute, and second are also available following similar patterns).
id
integer <int64>
The Quorum primary key for this record; guaranteed to be persistent and unique across all objects at this endpoint.
kw_seat_status
string
Seat status from Know Who
NOTE: Parameter accepts additional qualifiers appended to the end: kw_seat_status__in - The value for the record is in the provided array parameter (comma-separated values). kw_seat_status__contains, kw_seat_status__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) kw_seat_status__startswith, kw_seat_status__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) kw_seat_status__endswith, kw_seat_status__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) kw_seat_status__iexact - The value for the record is a case-insensitive exact match to the provided parameter. kw_seat_status__isnull - The value for the record is null (if true) or is not null.
kw_seat_status_code
boolean
Seat status code from Know Who
lastelection
number <decimal>
Percentage of vote in last election
NOTE: Parameter accepts additional qualifiers appended to the end: lastelection__in - The value for the record is in the provided array parameter (comma-separated values). lastelection__gt, lastelection__gte, lastelection__lt, lastelection__lte - The value for the record is greater than/less than (or equal to) the provided parameter. lastelection__isnull - The value for the record is null (if true) or is not null.
leadership_title
string
The last known leadership role held during this role, if any.
NOTE: Parameter accepts additional qualifiers appended to the end: leadership_title__in - The value for the record is in the provided array parameter (comma-separated values). leadership_title__contains, leadership_title__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) leadership_title__startswith, leadership_title__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) leadership_title__endswith, leadership_title__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) leadership_title__iexact - The value for the record is a case-insensitive exact match to the provided parameter. leadership_title__isnull - The value for the record is null (if true) or is not null.
lower_district_obj_id
integer <int64>
The lowerld with which this personrole is associated.
NOTE: Parameter accepts additional qualifiers appended to the end: lower_district_obj__in - The value for the record is in the provided array parameter (comma-separated values). lower_district_obj__isnull - The value for the record is null (if true) or is not null.
office
string
Most recent office address (shorter form)
NOTE: Parameter accepts additional qualifiers appended to the end: office__in - The value for the record is in the provided array parameter (comma-separated values). office__contains, office__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) office__startswith, office__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) office__endswith, office__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) office__iexact - The value for the record is a case-insensitive exact match to the provided parameter. office__isnull - The value for the record is null (if true) or is not null.
party
integer <int64>
The political party of the person.
NOTE: Parameter accepts additional qualifiers appended to the end: party__in - The value for the record is in the provided array parameter (comma-separated values). party__isnull - The value for the record is null (if true) or is not null.
NOTE: Parameter accepts additional qualifiers appended to the end: party_name__in - The value for the record is in the provided array parameter (comma-separated values). party_name__contains, party_name__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) party_name__startswith, party_name__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) party_name__endswith, party_name__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) party_name__iexact - The value for the record is a case-insensitive exact match to the provided parameter.
person_id
integer <int64>
The newperson with which this personrole is associated.
NOTE: Parameter accepts additional qualifiers appended to the end: person__in - The value for the record is in the provided array parameter (comma-separated values). person__isnull - The value for the record is null (if true) or is not null.
phone
string
The last known phone number of the official during this role, if known.
NOTE: Parameter accepts additional qualifiers appended to the end: phone__in - The value for the record is in the provided array parameter (comma-separated values). phone__contains, phone__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) phone__startswith, phone__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) phone__endswith, phone__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) phone__iexact - The value for the record is a case-insensitive exact match to the provided parameter. phone__isnull - The value for the record is null (if true) or is not null.
reelectionyear
integer <int64>
When is the person up for reelection
NOTE: Parameter accepts additional qualifiers appended to the end: reelectionyear__in - The value for the record is in the provided array parameter (comma-separated values). reelectionyear__gt, reelectionyear__gte, reelectionyear__lt, reelectionyear__lte - The value for the record is greater than/less than (or equal to) the provided parameter. reelectionyear__isnull - The value for the record is null (if true) or is not null.
region
integer <int64>
The Region which the person role is for.
NOTE: Parameter accepts additional qualifiers appended to the end: region__in - The value for the record is in the provided array parameter (comma-separated values).
The type of role this person has, like representative or municipal_executive
NOTE: Parameter accepts additional qualifiers appended to the end: role_type__in - The value for the record is in the provided array parameter (comma-separated values). role_type__isnull - The value for the record is null (if true) or is not null.
See the Enumeration Documentation CSV file located at Quorum_API_Enumeration_Values.csv, name RoleType, for an explanation of values.
Enum:12567891011122122232425262728293038999
senator_class
integer <int64>
For senators, their election class, which determines which years they are up for election.
NOTE: Parameter accepts additional qualifiers appended to the end: senator_class__in - The value for the record is in the provided array parameter (comma-separated values). senator_class__isnull - The value for the record is null (if true) or is not null.
See the Enumeration Documentation CSV file located at Quorum_API_Enumeration_Values.csv, name SenatorClass, for an explanation of values.
Enum:123
senator_rank
integer <int64>
For senators, their state rank, i.e. junior/senior. For historical data, this is their last known rank.
NOTE: Parameter accepts additional qualifiers appended to the end: senator_rank__in - The value for the record is in the provided array parameter (comma-separated values). senator_rank__isnull - The value for the record is null (if true) or is not null.
See the Enumeration Documentation CSV file located at Quorum_API_Enumeration_Values.csv, name SenatorRank, for an explanation of values.
Enum:12
startdate
string <date-time>
The date the role began (when the person took office).
NOTE: Parameter accepts additional qualifiers appended to the end: startdate__year, startdate__month, startdate__day - The value for the record matches the provided year/month/day (note that week_day, hour, minute, and second are also available following similar patterns).
state
string
For senators and representatives, the two-letter USPS abbrevation for the state or territory they are serving. Values are the abbreviations for the 50 states (each of which have at least one representative and two senators, assuming no vacancies) plus DC, PR, and the island territories AS, GU, MP, and VI (all of which have a non-voting delegate), and for really old historical data you will also find PI (Philippines, 1907-1946), DK (Dakota Territory, 1861-1889), and OR (Orleans Territory, 1806-1811) for non-voting delegates.
NOTE: Parameter accepts additional qualifiers appended to the end: state__in - The value for the record is in the provided array parameter (comma-separated values).
The state with which this personrole is associated.
NOTE: Parameter accepts additional qualifiers appended to the end: state_obj__in - The value for the record is in the provided array parameter (comma-separated values). state_obj__isnull - The value for the record is null (if true) or is not null.
travelviz_latitude
number <decimal>
Latitude from Zip-State combo for travel visualization
NOTE: Parameter accepts additional qualifiers appended to the end: travelviz_latitude__in - The value for the record is in the provided array parameter (comma-separated values). travelviz_latitude__gt, travelviz_latitude__gte, travelviz_latitude__lt, travelviz_latitude__lte - The value for the record is greater than/less than (or equal to) the provided parameter. travelviz_latitude__isnull - The value for the record is null (if true) or is not null.
travelviz_longitude
number <decimal>
Longitude from Zip-State combo for travel visualization
NOTE: Parameter accepts additional qualifiers appended to the end: travelviz_longitude__in - The value for the record is in the provided array parameter (comma-separated values). travelviz_longitude__gt, travelviz_longitude__gte, travelviz_longitude__lt, travelviz_longitude__lte - The value for the record is greater than/less than (or equal to) the provided parameter. travelviz_longitude__isnull - The value for the record is null (if true) or is not null.
upper_district_obj_id
integer <int64>
The upperld with which this personrole is associated.
NOTE: Parameter accepts additional qualifiers appended to the end: upper_district_obj__in - The value for the record is in the provided array parameter (comma-separated values). upper_district_obj__isnull - The value for the record is null (if true) or is not null.
website
string
The URL to the official website of the person during this role, if known.
NOTE: Parameter accepts additional qualifiers appended to the end: website__in - The value for the record is in the provided array parameter (comma-separated values). website__contains, website__icontains - The value for the record contains the string provided as a parameter within it (partial match). (Use 'icontains' for matching to be done case-insensitive) website__startswith, website__istartswith - The value for the record starts with the string provided as a parameter. (Use 'istartswith' for matching to be done case-insensitive) website__endswith, website__iendswith - The value for the record ends with the string provided as a parameter within it (partial match). (Use 'iendswith' for matching to be done case-insensitive) website__iexact - The value for the record is a case-insensitive exact match to the provided parameter. website__isnull - The value for the record is null (if true) or is not null.
limit
integer <int64>
Default: 20
The number of records to return (for pagination).
offset
integer <int64>
Default: 0
The number of records to offset the start of the data being returned (for pagination).