FN API: People 1.0 Documentation
Search for people that influence and create global policy
AUTHORIZATIONBasic Auth
Username
<username>
Password
<password>
GETSearch for people
https://data.fiscalnote.com/people/v1/search
AUTHORIZATIONBasic Auth
This request is using Basic Auth from collectionFN API: People 1.0 Documentation
HEADERS
Accept
application/json
PARAMS
name
Kamala Harris
Filter on name
role_type
legislator
Filter on role type
role_title
Vice President
Filter on role title
role_related_org_name
Office of the Vice President
Filter on role related organization name
role_related_org_id
6qkqMU2D
Filter on a role related organization id
role_related_seat_id
80M4oSRL
Filter on role related seat id
role_locality_code
US
Filter on role_locality_code
include_staffers
false
Filter based on the include_staffers
continuation_token
officia velit proident dolore
Continuation token for paging. When this parameter is null/not present, the first page of results will be returned. To retrieve additional pages, this value is returned in the response payload for each page, and can then be passed in this parameter on the next call to retrieve the next page. If the continuation_token returned in the response is null, there are no further pages to get (you have reached the end of the results).
limit
10
Results limit, or page size, for this request. Maximum number of entities that will be returned. The underlying implementation may already use a default value, typically 10, if none is specified.
Example Request
OK
curl
curl --location 'https://data.fiscalnote.com/people/v1/search?name=Kamala%20Harris&role_type=legislator&role_title=Vice%20President&role_related_org_name=Office%20of%20the%20Vice%20President&role_related_org_id=6qkqMU2D&role_related_seat_id=80M4oSRL&role_locality_code=US&include_staffers=false&continuation_token=officia%20velit%20proident%20dolore&limit=10' \
--header 'Authorization: Basic <credentials>'200 OK
Example Response
json
{
"results": [
{
"id": "PAo79fEA",
"name": {
"full": "Marc Berman",
"first": "Marc",
"last": "Berman",
"nick": "Marc",
"prefix": "Hon",
"suffix": "IV",
"pronunciation": "BUR-men"
},
"biography": [
{
"text": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"date": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"source": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
{
"text": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"date": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"source": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
}
],
"birthday": {
"day": 1,
"month": 12,
"year": 2020
},
"birthPlace": "Dallas, TX",
"family": "Dax and 4 children",
"photoUrl": "https://s3.amazonaws.com/fn-document-service-dev/file-by-sha384/16488f47fd61ea4f279e1a9670cf13972408d1cf8746d2d1a0166041c93d60913c2a6e66095df111db2573dda214ebab",
"gender": "MALE",
"roles": {
"member": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"governmentOfficial": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
}
},
{
"id": "PAo79fEA",
"name": {
"full": "Marc Berman",
"first": "Marc",
"last": "Berman",
"nick": "Marc",
"prefix": "Hon",
"suffix": "IV",
"pronunciation": "BUR-men"
},
"biography": [
{
"text": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"date": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"source": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
{
"text": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"date": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"source": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
}
],
"birthday": {
"day": 1,
"month": 12,
"year": 2020
},
"birthPlace": "Dallas, TX",
"family": "Dax and 4 children",
"photoUrl": "https://s3.amazonaws.com/fn-document-service-dev/file-by-sha384/16488f47fd61ea4f279e1a9670cf13972408d1cf8746d2d1a0166041c93d60913c2a6e66095df111db2573dda214ebab",
"gender": "MALE",
"roles": {
"member": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
],
"governmentOfficial": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
}
}
],
"continuation_token": "AhXqeJPsBEABci30hEoHXdQU9QE",
"estimated_total_results": 1123
}Content-Type
application/json
GETSearch by a single person by ID
https://data.fiscalnote.com/people/v1/:id
AUTHORIZATIONBasic Auth
This request is using Basic Auth from collectionFN API: People 1.0 Documentation
HEADERS
Accept
application/json
PARAMS
include_staffers
false
If true, also return information for the staffers related to each person's role as a government official.
PATH VARIABLES
id
AjVR8i9A
(Required)
Example Request
OK
curl
curl --location 'https://data.fiscalnote.com/people/v1/AjVR8i9A?include_staffers=false' \
--header 'Authorization: Basic <credentials>'200 OK
Example Response
json
{
"id": "PAo79fEA",
"name": {
"full": "Marc Berman",
"first": "Marc",
"last": "Berman",
"nick": "Marc",
"prefix": "Hon",
"suffix": "IV",
"pronunciation": "BUR-men"
},
"biography": [
{
"text": "Marc Berman was first elected to the California State Assembly in November 2016 to represent the 24th District, which includes southern San Mateo County and northern Santa Clara County in the heart of Silicon Valley. In the Assembly, Marc serves as chair of the Committee on Elections and Redistricting, where he has become a leading voice on protecting voters from deceptive elections practices, making election information more accessible to voters, and improving election cybersecurity and campaign finance disclosure. In addition, Marc is one of only two members to chair two select committees. The Select Committee on the Master Plan for Higher Education in California is taking a methodical review of the 1960 Master Plan to ensure that California's higher education system works for students in the 21st century economy. The Select Committee on the Census leads the Assembly's efforts in preparing California for the 2020 Census, which is used to determine the number of seats each state has in the House of Representatives as well as distribute tens of billions of dollars to state and local governments. Marc also serves on the following Assembly Standing Committees- Governmental Organization; Insurance; Privacy and Consumer Protection; and Transportation. In his first three years in the Assembly, Marc has had one of the highest rates of success in the Legislature, authoring legislation related to a number of issues, including elections, the 2020 Census, education, youth mental health, sexual assault, firearm safety, deepfakes, housing, and the environment. Marc has sent 47 bills to the Governor in his first three years in office. Marc served on the Palo Alto City Council prior to being elected to the Assembly, where he was a leader on issues such as infrastructure improvements and financial transparency. While serving on the Palo Alto City Council, Marc worked for the Silicon Valley Education Foundation, a non-profit focused on increasing access to high quality STEM education and closing the achievement gap in Silicon Valley public schools. Prior to his work in the non-profit sector, Marc was an attorney with Latham & Watkins LLP and Merino Yebri, LLP. Marc successfully represented pro bono clients seeking protection under the Violence Against Women Act and asylum in the United States due to political persecution in the Democratic Republic of the Congo. He also served as pro bono counsel to Spark, a national youth development non-profit. Marc was born in Dallas, Texas, and raised in Palo Alto, where he graduated from Palo Alto High School. He earned a degree in Political Science from Georgetown University. While in college, Marc began his public service in Palo Alto, working in Congresswoman Anna Eshoo's District Office. He also served as a summer analyst in the Voting Section of the Civil Rights Division of the Justice Department. Marc went on to graduate from law school at the University of Southern California, where he was elected president of the Student Bar Association and served for two years on the Southern California Law Review.",
"date": {
"day": 1,
"month": 12,
"year": 2020
},
"source": "Legislative Official Bio"
},
{
"text": "Marc Berman was first elected to the California State Assembly in November 2016 to represent the 24th District, which includes southern San Mateo County and northern Santa Clara County in the heart of Silicon Valley. In the Assembly, Marc serves as chair of the Committee on Elections and Redistricting, where he has become a leading voice on protecting voters from deceptive elections practices, making election information more accessible to voters, and improving election cybersecurity and campaign finance disclosure. In addition, Marc is one of only two members to chair two select committees. The Select Committee on the Master Plan for Higher Education in California is taking a methodical review of the 1960 Master Plan to ensure that California's higher education system works for students in the 21st century economy. The Select Committee on the Census leads the Assembly's efforts in preparing California for the 2020 Census, which is used to determine the number of seats each state has in the House of Representatives as well as distribute tens of billions of dollars to state and local governments. Marc also serves on the following Assembly Standing Committees- Governmental Organization; Insurance; Privacy and Consumer Protection; and Transportation. In his first three years in the Assembly, Marc has had one of the highest rates of success in the Legislature, authoring legislation related to a number of issues, including elections, the 2020 Census, education, youth mental health, sexual assault, firearm safety, deepfakes, housing, and the environment. Marc has sent 47 bills to the Governor in his first three years in office. Marc served on the Palo Alto City Council prior to being elected to the Assembly, where he was a leader on issues such as infrastructure improvements and financial transparency. While serving on the Palo Alto City Council, Marc worked for the Silicon Valley Education Foundation, a non-profit focused on increasing access to high quality STEM education and closing the achievement gap in Silicon Valley public schools. Prior to his work in the non-profit sector, Marc was an attorney with Latham & Watkins LLP and Merino Yebri, LLP. Marc successfully represented pro bono clients seeking protection under the Violence Against Women Act and asylum in the United States due to political persecution in the Democratic Republic of the Congo. He also served as pro bono counsel to Spark, a national youth development non-profit. Marc was born in Dallas, Texas, and raised in Palo Alto, where he graduated from Palo Alto High School. He earned a degree in Political Science from Georgetown University. While in college, Marc began his public service in Palo Alto, working in Congresswoman Anna Eshoo's District Office. He also served as a summer analyst in the Voting Section of the Civil Rights Division of the Justice Department. Marc went on to graduate from law school at the University of Southern California, where he was elected president of the Student Bar Association and served for two years on the Southern California Law Review.",
"date": {
"day": 1,
"month": 12,
"year": 2020
},
"source": "Legislative Official Bio"
}
],
"birthday": {
"day": 1,
"month": 12,
"year": 2020
},
"birthPlace": "Dallas, TX",
"family": "Dax and 4 children",
"photoUrl": "https://s3.amazonaws.com/fn-document-service-dev/file-by-sha384/16488f47fd61ea4f279e1a9670cf13972408d1cf8746d2d1a0166041c93d60913c2a6e66095df111db2573dda214ebab",
"gender": "MALE",
"roles": {
"member": [
{
"parent": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"resourceType": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"organization_type": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"type": "staffer",
"title": "State Committee Member",
"term": {
"start": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"end": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"isActive": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
}
},
{
"parent": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"resourceType": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"organization_type": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"type": "staffer",
"title": "State Committee Member",
"term": {
"start": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"end": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"isActive": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
}
}
],
"governmentOfficial": [
{
"seat": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"organization": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"type": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"title": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"locality_code": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"branch": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"district": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"term": {
"start": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"end": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"isActive": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"district": {
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"code": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"branch": "legislative",
"locality_code": "US-CA",
"title": "Representative",
"reelectionYear": 2022,
"contacts": {
"phones": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"emails": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"addresses": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"websites": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"staffers": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
},
{
"seat": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"organization": {
"id": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"type": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"title": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"locality_code": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"branch": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"district": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"term": {
"start": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"end": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"isActive": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"district": {
"name": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"code": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"branch": "legislative",
"locality_code": "US-CA",
"title": "Representative",
"reelectionYear": 2022,
"contacts": {
"phones": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"emails": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"addresses": {
"value": "<Error: Too many levels of nesting to fake this schema>"
},
"websites": {
"value": "<Error: Too many levels of nesting to fake this schema>"
}
},
"staffers": [
{
"value": "<Error: Too many levels of nesting to fake this schema>"
},
{
"value": "<Error: Too many levels of nesting to fake this schema>"
}
]
}
]
}
}Content-Type
application/json