apiary.apib

FORMAT: 1A
HOST: https://api.civil.services/v1

# API

![Civil Services Logo](https://cdn.civil.services/common/github-logo.png "Civil Services Logo")

Civil Services is a collection of tools that make it possible for citizens to be a part of what is happening in their Local, State & Federal Governments.

* _Maintained By:_ __[Peter Schmalfeldt](mailto:me@peterschmalfeldt.com)__
* _Last Modified:_ __February 24th, 2017__
* _Current API Version:_ __v1.0.0__

__IMPORTANT:__ Currently, our API is only open for select non-commercial use.  If you are interested in obtaining an API Key ( required for access ), please contact [hello@civil.services](mailto:hello@civil.services) or [Join us on Slack](https://slack.civil.services/bkx7n2).

[![API Documentation](https://raw.githubusercontent.com/CivilServiceUSA/api/master/docs/img/apiary.jpg)](http://docs.civilservices.apiary.io)

## Join us on Slack

__[Join us on Slack](https://slack.civil.services/bkx7n2)__ if you need help using our API, or you are interested in contributing.

[![Slack Team Invite](https://cdn.civil.services/common/slack-invite.png)](https://slack.civil.services/bkx7n2)


# Group API Basics

## API Overview

Our API has a default Rate Limit by IP Address to `2500` calls per day. We add the following headers so you can monitor your API Rate:

* __X-Rate-Limit-Limit__: The rate limit ceiling for that given request
* __X-Rate-Limit-Remaining__: The number of requests left for the 24 hour window
* __X-Rate-Limit-Reset__: The remaining window before the rate limit resets in UTC [epoch seconds](http://en.wikipedia.org/wiki/Unix_time)

If a specific IP Address exceeds this limit, the API will return a 429 HTTP JSON Response Error.  A sample of this is provided in the Artwork API endpoint.

## API Authentication

Our API requires an API Key to use.  We are not providing API Keys to the general public at this time.  You likely received an API Key before accessing this documentation, if not, please contact the individual who sent you here.

## You can set the API Key one of two ways

#### Request Header:

* __API-Key__ `243CEA2E-7E63-D2C4-3D2D-1A114288274B` _( this is not an actual API Key )_

#### GET Parameter:

* __?apikey=__ `243CEA2E-7E63-D2C4-3D2D-1A114288274B`

### HTTP Request Method Limits

### Common API Responses

The following parameters are available on every API endpoint and used for pagination
for if there are a lot of results.

+ `error` (boolean) - Whether or not there were errors in the API call.
+ `errors` (array) - An array of general errors.
+ `field_errors` (object) - If the error was in regards to data entry, any errors specific to an input field will return here with the input name and error message.
+ `meta` (object) - The META data object that contains the basic information about the API response.
+ `meta.total` (number) - Total number of all results.  Not just the number returned in the API call.
+ `meta.showing` (number) - Number of results returned in the current API call ( may be less than total results ).
+ `meta.pages` (number) - Number of pages of results.  This is based on the `total` results divided by the `pageSize`.
+ `meta.page` (number) - Current Page
+ `data` (object or array) - This is the the actual data returned for the API call.  For API calls that are expected to return a single result, the `data` will be an Object.  For API calls that are expecting multiple items returned, `data` will be returned as an array ( even if there is only one item returned, such as search results, etc ).

__Response 200:__ (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": {},
            "meta": {
                "total": 97,
                "showing": 30,
                "pages": 4,
                "page": 1
            },
            "data": [
                ...
            ]
        }

__Response 403:__ (application/json)

        {
            "error": true,
            "errors": ["Missing API Key"],
            "field_errors": {},
            "meta": {
                "total": 0,
                "showing": 0,
                "pages": 1,
                "page": 1
            },
            "data": []
        }

### Optional API Params

The following parameters are available on every API endpoint and used for pagination
for if there are a lot of results.

+ `pageSize` (number, optional) - How many results to return in a single API call. Defaults to 30
+ `page` (number, optional) - If there is more than one page of results, you can set which page to load here
+ `pretty` (optional) - If you want to format the JSON response to be human readable, just add a `pretty` param in the API call ( it does not need a value )

### Request Authorization Header

* __Authorization:__ Bearer `token`

An example API Header would look like this:

```
curl --data '' https://api.civil.services/v1/user/refresh/ -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VySWQiOiIyIiwiaWF0IjoxNDUxNzEyNzg0LCJleHAiOjE0NTIzMTc1ODQsImlzcyI6IkRvaW5nIEFQSSJ9.x3eJutiulLnJCJkl_jP9ETj43ihePVeMtaWgWF0I60w"
```


# Group API Access

If you are using the API to access User Endpoints ( https://api.civil.services/v1/user/* ) you will want to create a
`token` to manage the users sessions.  This is not the same as an `apikey` which is required for all API endpoints.  This
token is specifically for individual users and acts as a session id.

## Token [/token]

Once a user has logged in, you will need to send over their Authentication
Token in the HTTP Header.  A `token` is returned with a successful login.  A session
token is valid for 7 days.  You can refresh your token to prevent having to log in
again by either adding the Request Authorization Header below, or using the
`/api/0.1/user/refresh/` endpoint.

### Get Token [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE0NTU1MTQ2NzIsImV4cCI6MTQ1NjExOTQ3MiwiaXNzIjoiQ29kZXJzIEJ1aWxkIEFQSSJ9.PZagWEzVC2sr_QjcwvqvUB9lUUlFSNIT9gzY80XWAn4"
          }
        }

## Refresh Session [/user/refresh]

A `token` is returned with a successful login.  A session token is valid for 7 days.
You can refresh your token to prevent having to log in again by either adding the
Request Authorization Header below. `token` should be the string returned in the
`token` parameter from a successful login.

* __Authorization:__ Bearer `token`

### Refresh Session [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VySWQiOjIsImlhdCI6MTQ1MTc5ODYyMSwiZXhwIjoxNDUyNDAzNDIxLCJpc3MiOiJEb2luZyBBUEkifQ.za4PspEZfeVxydO3QHSFBLm_9PcrCBRwK9HLofBY74s"
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid or expired token"
          ],
          "meta": {},
          "data": []
        }


# Group Account Management

The following endpoints are specifically setup to manage the logged in users account.

__IMPORTANT:__ Account Creation is not enabled by default for API Users.  If you believe your application should be allowed to create user accounts, please contact us to let us know why.

## Register [/user/register/?username={username}&password={password}&retype_password={retype_password}&inviteCode={inviteCode}&first_name={first_name}&last_name={last_name}&email={email}&agree={agree}]

API Endpoint to register new users. This should set the user's `activated` field
to `true` unless they've included their email address. If so, `activated` is
`false` and the user will be sent an email with a `new_email_key` key to confirm
their email address to complete registration.

+ Parameters
    + username (string, required) - The username or email address of the account
        + Min Length: __3__
        + Max Length: __30__
        + Characters Allowed: __a-zA-Z0-9___
        + Case Insensitive
    + password (string, required) - The password to the account
        + Min Length: __6__
        + No Other Password Requirements :)
    + retype_password (string, required) - The password to the account
        + Min Length: __6__
        + No Other Password Requirements :)
    + inviteCode (string, required) - During Alpha / Beta testing, an Invitation Code is Required for registration
        + Length: __6__
        + Existing Users: __hash_id__
    + first_name (string, optional) - First Name - NOTE: Apple does not like requiring personal info for registration
        + Min Length: __1__
        + Max Length: __50__
    + last_name (string, optional) - Last Name - NOTE: Apple does not like requiring personal info for registration
        + Min Length: __1__
        + Max Length: __50__
    + email (string, optional) - Email Address - NOTE: Apple does not like requiring personal info for registration
        + Min Length: __1__
        + Max Length: __100__
    + agree (string, required) - Agree to TOS - User Agreed to Terms of Service

### User Register [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "banned": false,
            "id": "5",
            "username": "test",
            "first_name": "Test",
            "last_name": "User",
            "email": "test@email.com",
            "activated": false,
            "new_email_key": "TriqG3m344N8",
            "modified": "2016-01-03T03:59:45.465Z",
            "created": "2016-01-03T03:59:45.465Z",
            "banned_reason": null,
            "new_password_key": null,
            "new_password_requested": null,
            "new_email": null,
            "profile_photo": null
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [],
          "field_errors": {
            "username": [
              "Username is already in use"
            ],
            "email": [
              "Email is already in use"
            ]
          },
          "meta": {},
          "data": []
        }

## Confirm Account [/user/confirm/account/?key={key}]

During account registration, new users will be sent a link to confirm their
email address.  The users account will be disabled until the user confirms the email
address.


+ Parameters
    + key (required, string) - The `new_email_key` stored for the user

### Confirm Account [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "id": "5",
            "username": "test",
            "email": "test@email.com",
            "first_name": "Test",
            "last_name": "User",
            "activated": true,
            "banned": false,
            "banned_reason": null,
            "new_password_key": null,
            "new_password_requested": null,
            "new_email": null,
            "new_email_key": null,
            "profile_photo": null,
            "created": "2016-01-02T06:00:54.303Z",
            "modified": "2016-01-02T06:01:35.207Z",
            "banned": false
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": ["Error Saving User Account"],
          "meta": {},
          "data": []
        }

## Confirm Email Change [/user/confirm/email/?key={key}]

When a user changes their email, they will be sent a confirmation email to both
their new and old email address assuring it was them that requested the email
change.


+ Parameters
    + key (required, string) - The `new_email_key` stored for the user

### Confirm Email Change [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "id": "5",
            "username": "test",
            "email": "test@email.com",
            "first_name": "Test",
            "last_name": "User",
            "activated": true,
            "banned": false,
            "banned_reason": null,
            "new_password_key": null,
            "new_password_requested": null,
            "new_email": null,
            "new_email_key": null,
            "profile_photo": null,
            "created": "2016-01-02T06:00:54.303Z",
            "modified": "2016-01-02T06:01:35.207Z",
            "banned": false
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": ["Error Confirming Account"],
          "meta": {},
          "data": []
        }

## Confirm Password Change [/user/confirm/password/?key={key}]

When a user changes their password, they will be sent a confirmation email assuring
it was them that requested the password change.


+ Parameters
    + key (required, string) - The `new_email_key` stored for the user

### Confirm Password Change [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "id": "5",
            "username": "test",
            "email": "test@email.com",
            "first_name": "Test",
            "last_name": "User",
            "activated": true,
            "banned": false,
            "banned_reason": null,
            "new_password_key": null,
            "new_password_requested": null,
            "new_email": null,
            "new_email_key": null,
            "profile_photo": null,
            "created": "2016-01-02T06:00:54.303Z",
            "modified": "2016-01-02T06:01:35.207Z",
            "banned": false
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": ["Error Confirming Account"],
          "meta": {},
          "data": []
        }

## Login [/user/login/?username={username}&password={password}]

Some of the API endpoints will require authentication. Those endpoints will
require the `token` returned from a succesful login.

To access authentication-protected endpoints, you will need to include an
`Authorization` HTTP header in the format: `Bearer (token)`.

+ Parameters
    + username (string, required) - The username of the account
    + password (string, required) - The password to the account

### User Login [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "id": "5",
            "username": "test",
            "email": "test@email.com",
            "first_name": "Test",
            "last_name": "User",
            "activated": true,
            "banned": false,
            "banned_reason": null,
            "new_password_key": null,
            "new_password_requested": null,
            "new_email": null,
            "new_email_key": "TriqG3m344N8",
            "profile_photo": null,
            "created": "2016-01-03T03:59:45.465Z",
            "modified": "2016-01-03T03:59:45.465Z",
            "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VySWQiOiI1IiwiaWF0IjoxNDUxNzk0OTI2LCJleHAiOjE0NTIzOTk3MjYsImlzcyI6IkRvaW5nIEFQSSJ9.Y-ALQxsdTCf8zJvD-IUeobGTbgKbtNTvt3_JrUMOyXA"
          }
        }

+ Response 200 (application/json)

        {
          "error": true,
          "errors": ["User not active"],
          "meta": {},
          "data": []
        }

+ Response 200 (application/json)

        {
          "error": true,
          "errors": ["No user found with that username"],
          "meta": {},
          "data": []
        }

## Logout [/user/logout]

Tell API that the user has logged out

### User Logout [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {},
          "data": {
            "success": true
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": ["Invalid API Authorization Token"],
          "meta": {},
          "data": []
        }

## Forgot Password [/user/forgot-password/?email={email}]

Forgot password will require an email address that is requesting for the password
reset link.

+ Parameters
    + email (required, string) - The email address of the account

### User Forgot Password [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "message": "Check your email to obtain instructions on password reset."
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "We could not find that email address in our system."
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Reset Password [/user/reset-password/?token={token}&password={password}&retype_password={retype_password}]

Reset password will check the token against the `new_password_key` column for that user.  We will also likely want to make sure that `new_password_requested` is less than a certain age to prevent open password change requests.

+ Parameters
    + token (required, string) - This is the token that is sent from the link in the email address.
    + password (required, string) - This is the new password that the user wants to reset
    + retype_password (required, string) - This should be the same as 'password' and is the confirmation of the password

### User Reset Password [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "message": "You may now login with your new password."
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid Reset Password token."
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Resend Email Confirmation [/user/resend-confirmation/{hash_id}]

If the user needs to resend their email confirmation, this is the endpoint to use.

+ Parameters
    + hash_id (required, string) - This is the hash id of the user

### Resend Email Confirmation [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "message": "You may now login with your new password."
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid Reset Password token."
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Update Account [/user/update/?current_password={current_password}&username={username}&email={email}&password_new={password_new}&password_new_retype={password_new_retype}]

This endpoint will allow the logged in user to update their own account.  This uses the current Authentication Bearer Token to lookup who's account to update.

The Bearer Token is created during login and contains the users ID from our database.  You will not be able to use this endpoint to manage anyone else's account except your own.

IMPORTANT NOTES ABOUT THIS ENDPOINT:

1. Changing the username will immediately make the old username available to the world for use.  We do check to make sure that the new username being requested is available.
2. We do not immediately change the email when requested.  Instead we send a confirmation email to both the new and old email to confirm the requested change.
3. We do not immediately change the password when requested.  We first send a confirmation email to the users current email to confirm that they made the requested change.

+ Parameters
    + current_password (required, string) - Current Account Password ( required to make any changes on this endpoint )
    + username (optional, string) - New Username user wishes to change their username to
    + email (optional, string) - New Email Address user wishes to associate with their account
    + password_new (optional, string) - New Password user wishes to use for their account
    + password_new_retype (optional, string) - Repeat the new password to make sure they match so they don't get locked out

### Update Account [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Username is not available"
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Delete Account [/user/delete/?username={username}&password={password}]

This endpoint only works for the currently logged in user using the Authorization
Bearer Header Token.  Once that is verified there is a second check to require the
account holders username and password to double check that they just did not steal
the Authentication Header to try to steal / delete the users account.

IMPORTANT NOTES ABOUT THIS ENDPOINT:

1. This will permanently delete the users account
2. This will also permanently delete all data generated by the user
3. There is no way to undo this

+ Parameters
    + username (required, string) - Current Account User
    + password (required, string) - Current Account Password

### Delete Account [DELETE]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Incorrect Password"
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }


# Group User Interaction

The following endpoints are for accessing specific public data about a given
username.  No private information is accessible from these endpoints.

## Get User Profile [/user/{username}/profile]

Get a public profile for given `username`.

+ Parameters
    + username (required, string) - Username for requested profile

### Get User Profile [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "No Matching User Found"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }

## Follow User [/user/{username}/follow]

Add's `username` to the current logged in users follow list.

+ Parameters
    + username (required, string) - Username of user you wish to follow

### Follow User [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "No Matching User Found"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }

## Unfollow User [/user/{username}/unfollow]

Removes `username` from the current logged in users follow list.

+ Parameters
    + username (required, string) - Username of user you wish to unfollow

### Unfollow User [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "No Matching User Found"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }

## Get Followers [/user/{username}/followers]

Fetches list of users that is following `username`

+ Parameters
    + username (required, string) - Username to get followers list for

### Get Followers [GET]

+ Response 200 (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": { },
            "meta": {
                "total": 1,
                "showing": 1,
                "pages": 1,
                "page": 1
            },
            "data": [
                {
                    "id": 2,
                    "username": "manifestinteractive",
                    "profile_name": "Peter Schmalfeldt",
                    "profile_photo": "https://peterschmalfeldt.com/images/me.jpg",
                    "followed_on": "2016-03-05T08:30:04.000Z"
                }
            ]
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "Missing Username"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }

## Get Following [/user/{username}/following]

Fetches list of users `username` is following

+ Parameters
    + username (required, string) - Username to get following list for

### Get Following [GET]

+ Response 200 (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": { },
            "meta": {
                "total": 1,
                "showing": 1,
                "pages": 1,
                "page": 1
            },
            "data": [
                {
                    "id": 2,
                    "username": "manifestinteractive",
                    "profile_name": "Peter Schmalfeldt",
                    "profile_photo": "https://peterschmalfeldt.com/images/me.jpg",
                    "followed_on": "2016-03-05T08:30:04.000Z"
                }
            ]
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "Missing Username"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }

## Get Invitations [/user/invite/{key}]

Fetches list of users that have registered using the provided invite `key`

+ Parameters
    + key (required, string) - Invitation Key ( users hash_id )

### Get Invitations [GET]

+ Response 200 (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": { },
            "meta": {
                "total": 1,
                "showing": 1,
                "pages": 1,
                "page": 1
            },
            "data": [
                {
                    "id": 2,
                    "username": "manifestinteractive",
                    "profile_name": "Peter Schmalfeldt",
                    "profile_photo": "https://peterschmalfeldt.com/images/me.jpg",
                    "followed_on": "2016-03-05T08:30:04.000Z"
                }
            ]
        }

+ Response 400 (application/json)

        {
          "error": true,
          "errors": [
            "Missing Username"
          ],
          "field_errors": {},
          "meta": {
            "total": 0,
            "showing": 0,
            "pages": 1,
            "page": 1
          },
          "data": []
        }


# Group User Settings

The following endpoints for accessing & managing settings for the current logged
in user.  These endpoints only work for the user associated with the Authorization
Bearer Token sent in the header.  This uses the current Authentication Bearer Token
to lookup who's account to update. The Bearer Token is created during login and contains
the users ID from our database.  You will not be able to use this endpoint to manage
anyone elses account except your own.

## Get User Settings [/settings]

Gets account settings for current logged in user

### Get User Settings [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [

          ],
          "field_errors": {

          },
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "notifications": {
              "email_comment_left": true,
              "email_comment_liked": false,
              "email_mentioned_in_comment": true,
              "email_someone_follows": true,
              "newsletter": true,
              "web_comment_left": true,
              "web_comment_liked": true,
              "web_mentioned_in_comment": true,
              "web_someone_follows": false
            }
          }
        }

## Update Profile [/settings/profile/?profile_photo={profile_photo}&profile_name={profile_name}&location={location}&company_name={company_name}&first_name={first_name}&last_name={last_name}&bio={bio}]

This endpoint will allow the logged in user to update their own account profile.

+ Parameters
    + profile_photo (optional, string) - absolute path to location of User Avatar ( must be HTTPS to prevent issues )
        + Max Length: `255`
        + Default: null
    + profile_name (optional, string) - Public Display Name of User
        + Max Length: `100`
        + Default: Users Username
    + location (optional, string) - Public Pysical Location of User
        + Max Length: `50`
        + Default: null
    + company_name (optional, string) - Public Company the User works for
        + Max Length: `100`
        + Default: null
    + first_name (optional, string) - Private First Name ( never shown on site - for internal use only )
        + Max Length: `100`
        + Default: null
    + last_name (optional, string) - Private Last Name ( never shown on site - for internal use only )
        + Max Length: `100`
        + Default: null
    + bio (optional, string) - Public User Bio to display on website
        + Max Length: `255`
        + Default: null

### Update Profile [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "bio": "Front End Designer",
            "company_name": "Awesome Company",
            "email": "me@email.com",
            "first_name": "Jane",
            "hash_id": "yRdRYJ",
            "join_date": "2016-02-15T02:51:52.000Z",
            "last_name": "Doe",
            "location": "St. Petersburg, FL",
            "profile_link_1": "http://mywebsite.com",
            "profile_link_2": null,
            "profile_link_3": null,
            "profile_link_twitter": null,
            "profile_link_website": null,
            "profile_name": "Jane Doe",
            "profile_photo": null,
            "username": "janedoe"
          }
        }


## Update Social Links [/settings/social-links/?profile_link_github={profile_link_github}&profile_link_bitbucket={profile_link_bitbucket}&profile_link_twitter={profile_link_twitter}&profile_link_1={profile_link_1}&profile_link_2={profile_link_2}&profile_link_3={profile_link_3}]

This endpoint will allow the logged in user to update their own accounts Social Links.

+ Parameters
    + profile_link_github (optional, string) - Absolute URL to Github Profile Page
        + Max Length: `100`
        + Default: null
    + profile_link_bitbucket (optional, string) - Absolute URL to Bitbucket Profile Page
        + Max Length: `100`
        + Default: null
    + profile_link_twitter (optional, string) - Absolute URL to Twitter Profile Page
        + Max Length: `100`
        + Default: null
    + profile_link_1 (optional, string) - Absolute URL to a URL of the Users Choosing
        + Max Length: `100`
        + Default: null
    + profile_link_2 (optional, string) - Absolute URL to a URL of the Users Choosing
        + Max Length: `100`
        + Default: null
    + profile_link_3 (optional, string) - Absolute URL to a URL of the Users Choosing
        + Max Length: `100`
        + Default: null

### Update Social Links [POST]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid API Authorization Token"
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Update Email Notifications [/settings/email-notifications/?email_comment_left={email_comment_left}&email_comment_liked={email_comment_liked}&email_project_liked={email_project_liked}&email_someone_follows={email_someone_follows}&email_mentioned_in_comment={email_mentioned_in_comment}]

This endpoint will allow the logged in user to update their own accounts email notification settings.

+ Parameters
    + email_comment_left (boolean, optional) - DATA
        + Default: true
    + email_comment_liked (boolean, optional) - DATA
        + Default: true
    + email_project_liked (boolean, optional) - DATA
        + Default: true
    + email_someone_follows (boolean, optional) - DATA
        + Default: true
    + email_mentioned_in_comment (boolean, optional) - DATA
        + Default: true

### Update Email Notifications [POST]

+ Response 200 (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": {},
            "meta": {
                "total": 1,
                "showing": 1,
                "pages": 1,
                "page": 1
            },
            "data": {
                "email_comment_left": true,
                "email_comment_liked": false,
                "email_mentioned_in_comment": true,
                "email_project_liked": false,
                "email_someone_follows": true,
                "newsletter": true,
                "web_comment_left": true,
                "web_comment_liked": true,
                "web_mentioned_in_comment": true,
                "web_project_liked": false,
                "web_someone_follows": false
            }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid API Authorization Token"
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }

## Update Web Notifications [/settings/web-notifications/?web_comment_left={web_comment_left}&web_comment_liked={web_comment_liked}&web_project_liked={web_project_liked}&web_someone_follows={web_someone_follows}&web_mentioned_in_comment={web_mentioned_in_comment}]

This endpoint will allow the logged in user to update their own accounts web notification settings.

+ Parameters
    + web_comment_left (boolean, optional) - DATA
        + Default: true
    + web_comment_liked (boolean, optional) - DATA
        + Default: true
    + web_project_liked (boolean, optional) - DATA
        + Default: true
    + web_someone_follows (boolean, optional) - DATA
        + Default: true
    + web_mentioned_in_comment (boolean, optional) - DATA
        + Default: true

### Update Web Notifications [POST]

+ Response 200 (application/json)

        {
            "error": false,
            "errors": [],
            "field_errors": {},
            "meta": {
                "total": 1,
                "showing": 1,
                "pages": 1,
                "page": 1
            },
            "data": {
                "email_comment_left": true,
                "email_comment_liked": false,
                "email_mentioned_in_comment": true,
                "email_project_liked": false,
                "email_someone_follows": true,
                "newsletter": true,
                "web_comment_left": true,
                "web_comment_liked": true,
                "web_mentioned_in_comment": true,
                "web_project_liked": false,
                "web_someone_follows": false
            }
        }

+ Response 403 (application/json)

        {
          "error": true,
          "errors": [
            "Invalid API Authorization Token"
          ],
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {}
        }


# Group Application Data Endpoints

## Categories [/categories/{slug}]

Fetch a list of all categories.  Optionally, you can pass over a `slug` for a category to get a list of subcategories for that category.

+ Parameters
    + slug (optional, string) - Main category `slug` that will return subcategories

### Get Categories [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 2,
            "showing": 2,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "id": 1,
              "parent_id": null,
              "name": "Category One",
              "slug": "category-one",
              "subcategories": [
                {
                  "id": 3,
                  "parent_id": 1,
                  "name": "Subcategory One",
                  "slug": "subcategory-one"
                },
                {
                  "id": 4,
                  "parent_id": 1,
                  "name": "Subcategory Two",
                  "slug": "subcategory-two"
                },
                {
                  "id": 5,
                  "parent_id": 1,
                  "name": "Subcategory Three",
                  "slug": "subcategory-three"
                }
              ]
            },
            {
              "id": 2,
              "parent_id": null,
              "name": "Category Two",
              "slug": "category-two",
              "subcategories": [
                {
                  "id": 6,
                  "parent_id": 2,
                  "name": "Subcategory One",
                  "slug": "subcategory-one"
                },
                {
                  "id": 7,
                  "parent_id": 2,
                  "name": "Subcategory Two",
                  "slug": "subcategory-two"
                },
                {
                  "id": 8,
                  "parent_id": 2,
                  "name": "Subcategory Three",
                  "slug": "subcategory-three"
                }
              ]
            }
          ]
        }

## Tags [/tags]

Fetch a list of all tags being used.

### Get Tags [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 3,
            "showing": 3,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "id": 1,
              "name": "Tag One",
              "slug": "tag-one"
            },
            {
              "id": 2,
              "name": "Tag Two",
              "slug": "tag-two"
            },
            {
              "id": 3,
              "name": "Tag Three",
              "slug": "tag-three"
            }
          ]
        }

# Group Geolocation Endpoints

The following endpoints are for specific data related to Zip Codes and Geolocation data.

## Zipcode [/geolocation/zipcode/{zipcode}]

Fetch details for Specific Zipcode

+ Parameters
    + zipcode (string) -  Unique Zip Code

### Get Zipcode [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "type": "standard",
              "city": "Saint Petersburg",
              "state": "FL",
              "zipcode": "33701",
              "county": "Pinellas County",
              "country": "US",
              "timezone": "America/New_York",
              "location": {
                "lat": 27.75,
                "lon": -82.64
              },
              "area_codes": [
                "727"
              ],
              "alternate_city_names": [
                "St Petersburg"
              ],
              "estimated_population": 12000
            }
          ]
        }

## IP Address [/geolocation/ip/{ipaddress}]

Fetch details for Specific IP Address

+ Parameters
    + ipaddress (optional, string) -  IP Address to Lookup.
        + Default: Requester's IP Address

### Get IP Address [GET]

+ Response 200 (application/json)


        {
            "city": {
                "geoname_id": 5037649,
                "names": {
                    "de": "Minneapolis",
                    "en": "Minneapolis",
                    "es": "Mineápolis",
                    "fr": "Minneapolis",
                    "ja": "ミネアポリス",
                    "pt-BR": "Minneapolis",
                    "ru": "Миннеаполис",
                    "zh-CN": "明尼阿波利斯"
                }
            },
            "continent": {
                "code": "NA",
                "geoname_id": 6255149,
                "names": {
                    "de": "Nordamerika",
                    "en": "North America",
                    "es": "Norteamérica",
                    "fr": "Amérique du Nord",
                    "ja": "北アメリカ",
                    "pt-BR": "América do Norte",
                    "ru": "Северная Америка",
                    "zh-CN": "北美洲"
                }
            },
            "country": {
                "geoname_id": 6252001,
                "iso_code": "US",
                "names": {
                    "de": "USA",
                    "en": "United States",
                    "es": "Estados Unidos",
                    "fr": "États-Unis",
                    "ja": "アメリカ合衆国",
                    "pt-BR": "Estados Unidos",
                    "ru": "США",
                    "zh-CN": "美国"
                }
            },
            "location": {
                "latitude": 44.9759,
                "longitude": -93.2166,
                "metro_code": "613",
                "time_zone": "America/Chicago"
            },
            "postal": {
                "code": "55414"
            },
            "registered_country": {
                "geoname_id": 6252001,
                "iso_code": "US",
                "names": {
                    "de": "USA",
                    "en": "United States",
                    "es": "Estados Unidos",
                    "fr": "États-Unis",
                    "ja": "アメリカ合衆国",
                    "pt-BR": "Estados Unidos",
                    "ru": "США",
                    "zh-CN": "美国"
                }
            },
            "subdivisions": [
                {
                    "geoname_id": 5037779,
                    "iso_code": "MN",
                    "names": {
                        "en": "Minnesota",
                        "es": "Minnesota",
                        "ja": "ミネソタ州",
                        "ru": "Миннесота"
                    }
                }
            ]
        }

## Geolocation [/geolocation/?zipcode={zipcode}&city={city}&county={county}&state={state}&type={type}&areaCode={areaCode}&timezone={timezone}&minPopulation={minPopulation}&maxPopulation={maxPopulation}&latitude={latitude}&longitude={longitude}&distance={distance}]

Get Location Specific Data using any combination of filters.

+ Parameters
    + zipcode (optional, string) - Unique Zip Code
    + city (optional, string) - City to use as Filter
    + county (optional, string) - County to use as Filter
    + state (optional, string) - State to use as Filter
    + type (optional, string) - Type to use as Filter ['UNIQUE','PO BOX','STANDARD','MILITARY']
    + areaCode (optional, number) - Area Code of Phone Number to use as Filter
    + timezone (optional, string) - Time Zone of Location ( e.g. America/New_York )
    + minPopulation (optional, number) - Minimum Population of Location
    + maxPopulation (optional, number) - Maximum Population of Location
    + latitude (optional, number) - Latitude to base Location on
    + longitude (optional, number) - Longitude to base Location on
    + distance (optional, string) - Distance from Latitude & Longitude ( e.g. 5mi, 10km )

### Get Location [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 4,
            "showing": 4,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "type": "standard",
              "city": "Portland",
              "state": "OR",
              "zipcode": "97214",
              "county": "Multnomah County",
              "country": "US",
              "timezone": "America/Los_Angeles",
              "location": {
                "lat": 45.51,
                "lon": -122.64
              },
              "area_codes": [
                "503",
                "971"
              ],
              "alternate_city_names": [
                ""
              ],
              "estimated_population": 21730
            },
            {
              "type": "standard",
              "city": "Portland",
              "state": "OR",
              "zipcode": "97232",
              "county": "Multnomah County",
              "country": "US",
              "timezone": "America/Los_Angeles",
              "location": {
                "lat": 45.52,
                "lon": -122.64
              },
              "area_codes": [
                "971",
                "503"
              ],
              "alternate_city_names": [
                ""
              ],
              "estimated_population": 10780
            },
            {
              "type": "po box",
              "city": "Portland",
              "state": "OR",
              "zipcode": "97283",
              "county": "Multnomah County",
              "country": "US",
              "timezone": "America/Los_Angeles",
              "location": {
                "lat": 45.53,
                "lon": -122.65
              },
              "area_codes": [
                "971"
              ],
              "alternate_city_names": [
                ""
              ],
              "estimated_population": 426
            },
            {
              "type": "po box",
              "city": "Portland",
              "state": "OR",
              "zipcode": "97293",
              "county": "Multnomah County",
              "country": "US",
              "timezone": "America/Los_Angeles",
              "location": {
                "lat": 45.51,
                "lon": -122.64
              },
              "area_codes": [
                "971"
              ],
              "alternate_city_names": [
                ""
              ],
              "estimated_population": 410
            }
          ]
        }

# Group Legislator Endpoints

The following endpoints convert location data into parameters that can fetch Legislators from Open States.

## Legislators [/legislators/?zipcode={zipcode}&latitude={latitude}&longitude={longitude}]

Search for Legislators for a Given Location

+ Parameters
    + zipcode (optional, string) - Zip Code ( must be a valid US Zip Code )
    + latitude (optional, string) - GPS Latitude ( required if also passing over `longitude` )
    + longitude (optional, string) - GPS Longitude ( required if also passing over `latitude` )

### Get Legislators [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 1,
            "showing": 1,
            "pages": 1,
            "page": 1
          },
          "data": {
            "request": {
              "latitude": 45.52,
              "longitude": -122.64,
              "zipcode": "97232"
            },
            "results": [
              {
                "last_name": "Nosse",
                "updated_at": "2016-05-12 07:27:47",
                "sources": [
                  {
                    "url": "http://www.oregonlegislature.gov/house/Pages/RepresentativesAll.aspx"
                  }
                ],
                "full_name": "Rob Nosse",
                "old_roles": {
                  "2013-2014": [
                    {
                      "term": "2013-2014",
                      "end_date": null,
                      "district": "42",
                      "chamber": "lower",
                      "state": "or",
                      "party": "Democrat",
                      "type": "member",
                      "start_date": null
                    }
                  ]
                },
                "id": "ORL000259",
                "first_name": "Rob",
                "middle_name": "",
                "district": "42",
                "state": "or",
                "boundary_id": "ocd-division/country:us/state:or/sldl:42",
                "email": "Rep.RobNosse@state.or.us",
                "all_ids": [
                  "ORL000259",
                  "ORL000340"
                ],
                "leg_id": "ORL000259",
                "party": "Democrat",
                "active": true,
                "transparencydata_id": "",
                "nickname": "",
                "photo_url": "http://www.oregonlegislature.gov/house/MemberPhotos/nosse.jpg",
                "roles": [
                  {
                    "term": "2015-2016",
                    "end_date": null,
                    "district": "42",
                    "chamber": "lower",
                    "state": "or",
                    "party": "Democrat",
                    "type": "member",
                    "start_date": null
                  }
                ],
                "url": "http://www.oregonlegislature.gov/nosse",
                "created_at": "2014-07-07 23:28:46",
                "chamber": "lower",
                "offices": [
                  {
                    "fax": null,
                    "name": "Capitol Office",
                    "phone": "503-986-1442",
                    "address": "900 Court St NE, H-472, Salem, OR 97301",
                    "type": "capitol",
                    "email": "Rep.RobNosse@state.or.us"
                  }
                ],
                "suffixes": ""
              },
              {
                "last_name": "Rosenbaum",
                "+capitol_address": "900 Court St NE, S-223, Salem, OR 97301",
                "updated_at": "2016-05-12 07:27:47",
                "sources": [
                  {
                    "url": "http://www.oregonlegislature.gov/senate/Pages/SenatorsAll.aspx"
                  }
                ],
                "full_name": "Diane Rosenbaum",
                "old_roles": {
                  "2013-2014": [
                    {
                      "term": "2013-2014",
                      "end_date": null,
                      "district": "21",
                      "chamber": "upper",
                      "state": "or",
                      "party": "Democrat",
                      "type": "member",
                      "start_date": null
                    }
                  ],
                  "2011-2012": [
                    {
                      "term": "2011-2012",
                      "end_date": null,
                      "district": "21",
                      "chamber": "upper",
                      "state": "or",
                      "party": "Democratic",
                      "type": "member",
                      "start_date": null
                    }
                  ]
                },
                "+district_address": "1125 SE Madison St., Suite 100B, Portland, OR 97214",
                "first_name": "Diane",
                "middle_name": "",
                "district": "21",
                "id": "ORL000023",
                "state": "or",
                "votesmart_id": "23660",
                "party": "Democrat",
                "+district_phone": "503-231-9970",
                "email": "Sen.DianeRosenbaum@state.or.us",
                "+oregon_member_id": "48",
                "all_ids": [
                  "ORL000023",
                  "ORL000183",
                  "ORL000282"
                ],
                "leg_id": "ORL000023",
                "boundary_id": "ocd-division/country:us/state:or/sldu:21",
                "active": true,
                "transparencydata_id": "1490a9c428bf4603a3832f5387222f5c",
                "nickname": "",
                "photo_url": "http://www.oregonlegislature.gov/senate/MemberPhotos/rosenbaum.jpg",
                "+phone": "503-986-1700",
                "roles": [
                  {
                    "term": "2015-2016",
                    "end_date": null,
                    "district": "21",
                    "chamber": "upper",
                    "state": "or",
                    "party": "Democrat",
                    "type": "member",
                    "start_date": null
                  }
                ],
                "level": "state",
                "url": "http://www.oregonlegislature.gov/rosenbaum",
                "country": "us",
                "created_at": "2011-06-13 14:45:49",
                "chamber": "upper",
                "+website": "http://www.leg.state.or.us/rosenbaum",
                "offices": [
                  {
                    "fax": null,
                    "name": "Capitol Office",
                    "phone": "503-986-1721",
                    "address": "900 Court St NE, S-213, Salem, OR, 97301",
                    "type": "capitol",
                    "email": "Sen.DianeRosenbaum@state.or.us"
                  }
                ],
                "suffixes": ""
              }
            ]
          }
        }


# Group Senate Endpoints

View Contact Information for United States Senators, including: Phone Number, Mailing Address, Official Website, Twitter & Facebook Accounts.

## Senate [/senate/?state={state}&class={class}&bioguide={bioguide}&thomas={thomas}&govtrack={govtrack}&opensecrets={opensecrets}&votesmart={votesmart}&fec={fec}&maplight={maplight}&googleEntityId={googleEntityId}&title={title}&party={party}&name={name}&gender={gender}&ethnicity={ethnicity}&religion={religion}&openlyLGBTQ={openlyLGBTQ}&age={age}&minAge={minAge}&maxAge={maxAge}]

Search for Senator using any combination of search parameters.  

+ Parameters
    + state (optional, string) - State ( Full State Name or Two Letter Abbreviation )
    + class (optional, enum)
        
        Senate to be divided into three classes for purposes of elections. Using a comma to filter with multiple options, e.g. `?title=I,III`
        
        + Values
            + `I`
            + `II`
            + `III`
    + bioguide (optional, string) - The alphanumeric ID for this Senator on bioguide.congress.gov
    + thomas (optional, string) - The numeric ID for this Senator ( not really used anymore )
    + govtrack (optional, string) - The numeric ID for this Senator on GovTrack.us
    + opensecrets (optional, string) - The alphanumeric ID for this Senator on OpenSecrets.org
    + votesmart (optional, string) - The numeric ID for this Senator on VoteSmart.org
    + fec (optional, string) - Federal Election Commission ID
    + maplight (optional, string) - The numeric ID for this Senator on MapLight.org
    + wikidata (optional, string) - The numeric ID for this Senator on wikidata.org
    + googleEntityId (optional, string) - Google Integration
    + title (optional, enum)
        
        Title of Senator. Using a comma to filter with multiple options, e.g. `?title=senate-majority-leader,senate-minority-leader`
        
        + Values
            + `senator`
            + `senate-majority-leader`
            + `senate_majority-whip`
            + `senate-minority-leader`
            + `senate-minority-whip`
    + party (optional, enum) - 
        
        Political Party of Senator. Using a comma to filter with multiple options, e.g. `?title=democrat,republican`
        
        + Values
            + `constitution`
            + `democrat`
            + `green`
            + `independent`
            + `libertarian`
            + `nonpartisan`
            + `republican`
    + name (optional, string) - Full Name of Senator
    + gender (optional, enum)
        
        Gender of Senator. Using a comma to filter with multiple options, e.g. `?title=african-american,asian-american`
        
        + Values
            + `female`
            + `male`
            + `unspecified`
    + ethnicity (optional, enum)
        
        Ethnicity of Senator
        
        + Values
            + `african-american`
            + `asian-american`
            + `hispanic-american`
            + `middle-eastern-american`
            + `multi-racial-american`
            + `native-american`
            + `pacific-islander`
            + `white-american`
            + `unspecified`
    + religion (optional, enum)
        
        Religion of Senator. Using a comma to filter with multiple options, e.g. `?title=muslim,jewish`
        
        + Values
            + `african-methodist`
            + `anglican`
            + `baptist`
            + `buddhism`
            + `christian`
            + `christian-reformed`
            + `christian-scientist`
            + `church-of-christ`
            + `church-of-god`
            + `congregationalist`
            + `deist`
            + `eastern-orthodox`
            + `episcopalian`
            + `evangelical`
            + `evangelical-lutheran`
            + `hindu`
            + `jewish`
            + `jodo-shinshu-buddhist`
            + `lutheran`
            + `methodist`
            + `mormon`
            + `muslim`
            + `nazarene-christian`
            + `pentecostal`
            + `presbyterian`
            + `protestant`
            + `roman-catholic`
            + `seventh-day-adventist-church`
            + `soka-gakkai-buddhist`
            + `southern-baptist`
            + `united-church-of-christ`
            + `united-methodist`
            + `unitarian-universalist`
            + `unspecified`
    + openlyLGBTQ (optional, enum)
        
        Senator is Openly LGBTQ. Using a comma to filter with multiple options, e.g. `?title=lesbian,gay`
        
        + Values
            + `no`
            + `lesbian`
            + `gay`
            + `bisexual`
            + `transgender`
            + `queer`
    + age (optional, number) - Age of Senator
    + minAge (optional, number) - Minimum Age of Senator
    + maxAge (optional, number) - Maximum Age of Senator

### Get Senators [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 2,
            "showing": 2,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "address_city": "Washington",
              "address_complete": "284 Russell, Washington, DC 20510",
              "address_number": null,
              "address_prefix": null,
              "address_sec_unit_num": null,
              "address_sec_unit_type": null,
              "address_state": "DC",
              "address_street": "284 Russell",
              "address_type": "Building",
              "address_zipcode": "20510",
              "age": 45,
              "biography": "Marco Rubio, a Senator from Florida; born in Miami, Fla., May 28, 1971; graduated University of Florida, B.S., 1993; graduated University of Miami, J.D., 1996; lawyer; West Miami City Commission 1998-2000; member of the Florida house of representatives 2000-2008; majority leader 2003-2006; speaker 2006-2008; elected as a Republican to the United States Senate for the term ending January 3, 2017.",
              "bioguide": "R000595",
              "bioguide_url": "http://bioguide.congress.gov/scripts/biodisplay.pl?index=R000595",
              "class": "III",
              "contact_page": "https://www.rubio.senate.gov/public/index.cfm/contact",
              "date_of_birth": "1971-05-28T00:00:00.000Z",
              "entered_office": "2011-01-03T00:00:00.000Z",
              "ethnicity": "hispanic-american",
              "facebook_url": "https://www.facebook.com/SenatorMarcoRubio",
              "fax": null,
              "fec": null,
              "fec_url": null,
              "first_name": "Marco",
              "gender": "male",
              "goes_by": null,
              "google_entity_id": null,
              "govtrack": "412491",
              "govtrack_url": "https://www.govtrack.us/congress/members/412491",
              "last_name": "Rubio",
              "latitude": 38.8925,
              "longitude": -77.0074,
              "maplight": null,
              "maplight_url": null,
              "middle_name": null,
              "name": "Marco Rubio",
              "name_slug": "marco-rubio",
              "name_suffix": null,
              "openly_lgbtq": "no",
              "opensecrets": "N00030612",
              "opensecrets_url": "https://www.opensecrets.org/politicians/summary.php?cid=N00030612",
              "opensecrets_url_tabs": {
                "summary": "https://www.opensecrets.org/politicians/summary.php?cid=N00030612",
                "elections": "https://www.opensecrets.org/politicians/elections.php?cid=N00030612",
                "industries": "https://www.opensecrets.org/politicians/industries.php?cid=N00030612",
                "pacs": "https://www.opensecrets.org/politicians/pacs.php?cid=N00030612",
                "donors": "https://www.opensecrets.org/politicians/contrib.php?cid=N00030612",
                "geography": "https://www.opensecrets.org/politicians/geog.php?cid=N00030612",
                "expenditures": "https://www.opensecrets.org/politicians/expend.php?cid=N00030612",
                "legislation": "https://www.opensecrets.org/politicians/bills.php?cid=N00030612",
                "news": "https://www.opensecrets.org/politicians/inthenews.php?cid=N00030612",
                "other": "https://www.opensecrets.org/politicians/otherdata.php?cid=N00030612"
              },
              "party": "republican",
              "phone": "202-224-3041",
              "photo_url": "https://cdn.civil.services/us-senate/headshots/512x512/marco-rubio.jpg",
              "photo_url_sizes": {
                "64x64": "https://cdn.civil.services/us-senate/headshots/64x64/marco-rubio.jpg",
                "128x128": "https://cdn.civil.services/us-senate/headshots/128x128/marco-rubio.jpg",
                "256x256": "https://cdn.civil.services/us-senate/headshots/256x256/marco-rubio.jpg",
                "512x512": "https://cdn.civil.services/us-senate/headshots/512x512/marco-rubio.jpg",
                "1024x1024": "https://cdn.civil.services/us-senate/headshots/1024x1024/marco-rubio.jpg"
              },
              "pronunciation": "MAR-koh ROO-bee-oh",
              "religion": "roman-catholic",
              "state_code": "FL",
              "state_code_slug": "fl",
              "state_name": "Florida",
              "state_name_slug": "florida",
              "term_end": "2023-01-03T00:00:00.000Z",
              "thomas": "2084",
              "title": "senator",
              "twitter_handle": "marcorubio",
              "twitter_url": "https://twitter.com/marcorubio",
              "votesmart": "1601",
              "votesmart_url": "http://votesmart.org/candidate/1601",
              "votesmart_url_tabs": {
                "summary": "http://votesmart.org/candidate/1601",
                "bio": "http://votesmart.org/candidate/biography/1601",
                "votes": "http://votesmart.org/candidate/key-votes/1601",
                "positions": "http://votesmart.org/candidate/political-courage-test/1601",
                "ratings": "http://votesmart.org/candidate/evaluations/1601",
                "speeches": "http://votesmart.org/candidate/public-statements/1601",
                "funding": "http://votesmart.org/candidate/campaign-finance/1601"
              },
              "website": "http://www.rubio.senate.gov",
              "wikidata": null,
              "wikidata_url": null
            },
            {
              "address_city": "Washington",
              "address_complete": "716 Hart, Washington, DC 20510",
              "address_number": null,
              "address_prefix": null,
              "address_sec_unit_num": null,
              "address_sec_unit_type": null,
              "address_state": "DC",
              "address_street": "716 Hart",
              "address_type": "Building",
              "address_zipcode": "20510",
              "age": 74,
              "biography": "Bill Nelson, a Senator and a Representative from Florida; born in Miami, Dade County, Fla., September 29, 1942; attended the Brevard County public schools; graduated from Melbourne High School 1960; B.A., Yale University 1965; J.D., University of Virginia School of Law 1968; admitted to the Florida bar in 1968 and commenced practice in Melbourne in 1970; served in United States Army Reserve 1965-1971; United States Army, active duty, 1968-1970, achieving rank of captain; legislative assistant to Governor Reubin Askew 1971; elected to Florida State house of representatives in 1972 and reelected in 1974 and 1976; elected as a Democrat to the Ninety-sixth and to the five succeeding Congresses (January 3, 1979-January 3, 1991); was not a candidate for reelection in 1990 to the House of Representatives, but was a candidate for nomination for governor of Florida; crewmember on the twenty-fourth flight of the Space Shuttle Columbia, January 12-18, 1986; Florida treasurer and insurance commissioner 1995-2000; elected to the United States Senate in 2000 for the term commencing January 3, 2001; reelected in 2006 and again in 2012 for the term ending January 3, 2019; Chair, Special Committee on Aging (One Hundred Thirteenth Congress).",
              "bioguide": "N000032",
              "bioguide_url": "http://bioguide.congress.gov/scripts/biodisplay.pl?index=N000032",
              "class": "I",
              "contact_page": "https://www.billnelson.senate.gov/contact-bill",
              "date_of_birth": "1942-09-29T00:00:00.000Z",
              "entered_office": "2001-01-03T00:00:00.000Z",
              "ethnicity": "white-american",
              "facebook_url": "https://www.facebook.com/billnelson/",
              "fax": "202-228-2183",
              "fec": null,
              "fec_url": null,
              "first_name": "Bill",
              "gender": "male",
              "goes_by": null,
              "google_entity_id": null,
              "govtrack": "300078",
              "govtrack_url": "https://www.govtrack.us/congress/members/300078",
              "last_name": "Nelson",
              "latitude": 38.8928,
              "longitude": -77.0044,
              "maplight": null,
              "maplight_url": null,
              "middle_name": null,
              "name": "Bill Nelson",
              "name_slug": "bill-nelson",
              "name_suffix": null,
              "openly_lgbtq": "no",
              "opensecrets": "N00009926",
              "opensecrets_url": "https://www.opensecrets.org/politicians/summary.php?cid=N00009926",
              "opensecrets_url_tabs": {
                "summary": "https://www.opensecrets.org/politicians/summary.php?cid=N00009926",
                "elections": "https://www.opensecrets.org/politicians/elections.php?cid=N00009926",
                "industries": "https://www.opensecrets.org/politicians/industries.php?cid=N00009926",
                "pacs": "https://www.opensecrets.org/politicians/pacs.php?cid=N00009926",
                "donors": "https://www.opensecrets.org/politicians/contrib.php?cid=N00009926",
                "geography": "https://www.opensecrets.org/politicians/geog.php?cid=N00009926",
                "expenditures": "https://www.opensecrets.org/politicians/expend.php?cid=N00009926",
                "legislation": "https://www.opensecrets.org/politicians/bills.php?cid=N00009926",
                "news": "https://www.opensecrets.org/politicians/inthenews.php?cid=N00009926",
                "other": "https://www.opensecrets.org/politicians/otherdata.php?cid=N00009926"
              },
              "party": "democrat",
              "phone": "202-224-5274",
              "photo_url": "https://cdn.civil.services/us-senate/headshots/512x512/bill-nelson.jpg",
              "photo_url_sizes": {
                "64x64": "https://cdn.civil.services/us-senate/headshots/64x64/bill-nelson.jpg",
                "128x128": "https://cdn.civil.services/us-senate/headshots/128x128/bill-nelson.jpg",
                "256x256": "https://cdn.civil.services/us-senate/headshots/256x256/bill-nelson.jpg",
                "512x512": "https://cdn.civil.services/us-senate/headshots/512x512/bill-nelson.jpg",
                "1024x1024": "https://cdn.civil.services/us-senate/headshots/1024x1024/bill-nelson.jpg"
              },
              "pronunciation": "BILL NELL-suhn",
              "religion": "christian",
              "state_code": "FL",
              "state_code_slug": "fl",
              "state_name": "Florida",
              "state_name_slug": "florida",
              "term_end": "2019-01-03T00:00:00.000Z",
              "thomas": "859",
              "title": "senator",
              "twitter_handle": "SenBillNelson",
              "twitter_url": "https://twitter.com/SenBillNelson",
              "votesmart": "1606",
              "votesmart_url": "http://votesmart.org/candidate/1606",
              "votesmart_url_tabs": {
                "summary": "http://votesmart.org/candidate/1606",
                "bio": "http://votesmart.org/candidate/biography/1606",
                "votes": "http://votesmart.org/candidate/key-votes/1606",
                "positions": "http://votesmart.org/candidate/political-courage-test/1606",
                "ratings": "http://votesmart.org/candidate/evaluations/1606",
                "speeches": "http://votesmart.org/candidate/public-statements/1606",
                "funding": "http://votesmart.org/candidate/campaign-finance/1606"
              },
              "website": "http://www.billnelson.senate.gov",
              "wikidata": null,
              "wikidata_url": null
            }
          ],
          "attribution": {
            "text": "Data Provided by Civil Services",
            "website": "https://civil.services",
            "link": "<a href=\"https://civil.services\">Data Provided by Civil Services</a>",
            "license": "https://raw.githubusercontent.com/CivilServiceUSA/api/master/LICENSE",
            "logo": "https://cdn.civil.services/common/logo.png",
            "icon": "https://cdn.civil.services/common/icon.png"
          }
        }

# Group House Endpoints

View Contact Information for United States House Representatives, including: Phone Number, Mailing Address, Official Website, Twitter & Facebook Accounts.

## House [/house/?state={state}&district={district}&atLarge={atLarge}&vacant={vacant}&bioguide={bioguide}&thomas={thomas}&govtrack={govtrack}&opensecrets={opensecrets}&votesmart={votesmart}&fec={fec}&maplight={maplight}&googleEntityId={googleEntityId}&title={title}&party={party}&name={name}&gender={gender}&ethnicity={ethnicity}&religion={religion}&openlyLGBTQ={openlyLGBTQ}&age={age}&minAge={minAge}&maxAge={maxAge}]

Search for House Representative using any combination of search parameters.  

+ Parameters
    + state (optional, string) - State ( Full State Name or Two Letter Abbreviation )
    + district (optional, number) - District of Representative ( not always available )
    + atLarge (optional, boolean) - Representative is considered At-Large
    + vacant (optional, boolean) - Representative Seat is Vacant
    + bioguide (optional, string) - The alphanumeric ID for this Senator on bioguide.congress.gov
    + thomas (optional, string) - The numeric ID for this Senator ( not really used anymore )
    + govtrack (optional, string) - The numeric ID for this Senator on GovTrack.us
    + opensecrets (optional, string) - The alphanumeric ID for this Senator on OpenSecrets.org
    + votesmart (optional, string) - The numeric ID for this Senator on VoteSmart.org
    + fec (optional, string) - Federal Election Commission ID
    + maplight (optional, string) - The numeric ID for this Senator on MapLight.org
    + wikidata (optional, string) - The numeric ID for this Senator on wikidata.org
    + googleEntityId (optional, string) - Google Integration
    + title (optional, enum)
        
        Title of Senator. Using a comma to filter with multiple options, e.g. `?title=house-majority-leader,house-minority-leader`
        
        + Values
            + `representative`
            + `house-speaker`
            + `house-majority-leader`
            + `house-majority-whip`
            + `house-minority-leader`
            + `house-minority-whip`
            + `republican-conference-chairman`
            + `republican-policy-committee-chairman`
            + `assistant-democratic-leader`
            + `democratic-caucus-chairman`
    + party (optional, enum) - 
        
        Political Party of Senator. Using a comma to filter with multiple options, e.g. `?title=democrat,republican`
        
        + Values
            + `constitution`
            + `democrat`
            + `green`
            + `independent`
            + `libertarian`
            + `nonpartisan`
            + `republican`
    + name (optional, string) - Full Name of Senator
    + gender (optional, enum)
        
        Gender of Senator. Using a comma to filter with multiple options, e.g. `?title=african-american,asian-american`
        
        + Values
            + `female`
            + `male`
            + `unspecified`
    + ethnicity (optional, enum)
        
        Ethnicity of Senator
        
        + Values
            + `african-american`
            + `asian-american`
            + `hispanic-american`
            + `middle-eastern-american`
            + `multi-racial-american`
            + `native-american`
            + `pacific-islander`
            + `white-american`
            + `unspecified`
    + religion (optional, enum)
        
        Religion of Senator. Using a comma to filter with multiple options, e.g. `?title=muslim,jewish`
        
        + Values
            + `african-methodist`
            + `anglican`
            + `baptist`
            + `buddhism`
            + `christian`
            + `christian-reformed`
            + `christian-scientist`
            + `church-of-christ`
            + `church-of-god`
            + `congregationalist`
            + `deist`
            + `eastern-orthodox`
            + `episcopalian`
            + `evangelical`
            + `evangelical-lutheran`
            + `hindu`
            + `jewish`
            + `jodo-shinshu-buddhist`
            + `lutheran`
            + `methodist`
            + `mormon`
            + `muslim`
            + `nazarene-christian`
            + `pentecostal`
            + `presbyterian`
            + `protestant`
            + `roman-catholic`
            + `seventh-day-adventist-church`
            + `soka-gakkai-buddhist`
            + `southern-baptist`
            + `united-church-of-christ`
            + `united-methodist`
            + `unitarian-universalist`
            + `unspecified`
    + openlyLGBTQ (optional, enum)
        
        Senator is Openly LGBTQ. Using a comma to filter with multiple options, e.g. `?title=lesbian,gay`
        
        + Values
            + `no`
            + `lesbian`
            + `gay`
            + `bisexual`
            + `transgender`
            + `queer`
    + age (optional, number) - Age of Senator
    + minAge (optional, number) - Minimum Age of Senator
    + maxAge (optional, number) - Maximum Age of Senator

### Get House Representatives [GET]

+ Response 200 (application/json)

        {
          "error": false,
          "errors": [],
          "field_errors": {},
          "meta": {
            "total": 2,
            "showing": 2,
            "pages": 1,
            "page": 1
          },
          "data": [
            {
              "address_city": "Washington",
              "address_complete": "2436 Rayburn Hob, Washington, DC 20515",
              "address_number": "2436",
              "address_prefix": null,
              "address_sec_unit_num": null,
              "address_sec_unit_type": null,
              "address_state": "DC",
              "address_street": "Rayburn Hob",
              "address_type": null,
              "address_zipcode": "20515",
              "age": 56,
              "at_large": false,
              "biography": "Susan Brooks, a Representative from Indiana; born in Auburn, Dekalb County, Ind., August 25, 1960; B.A., Miami University, Oxford, Ohio, 1982; J.D., Indiana University, Indianapolis, Ind., 1985; lawyer, private practice; Indianapolis, Ind., deputy mayor, 1998-1999; U.S. attorney for the Southern District of Indiana, 2001-2007; administrator, Ivy Tech Community College, Indianapolis, Ind.; elected as a Republican to the One Hundred Thirteenth and to the two succeeding Congresses (January 3, 2013-present); chair, Committee on Ethics (One Hundred Fifteenth Congress).",
              "bioguide": "B001284",
              "bioguide_url": "http://bioguide.congress.gov/scripts/biodisplay.pl?index=B001284",
              "contact_page": "https://susanwbrooks.house.gov/contact/email-me",
              "date_of_birth": "1960-08-25T00:00:00.000Z",
              "district": 5,
              "entered_office": "2013-01-03T00:00:00.000Z",
              "ethnicity": "white-american",
              "facebook_url": "https://www.facebook.com/CongresswomanSusanWBrooks/",
              "fax": "202-225-0016",
              "fec": "H2IN05082",
              "fec_url": "http://www.fec.gov/fecviewer/CandidateCommitteeDetail.do?candidateCommitteeId=H2IN05082",
              "first_name": "Susan",
              "gender": "female",
              "goes_by": null,
              "google_entity_id": "kg:/m/0jt8ng2",
              "govtrack": "412539",
              "govtrack_url": "https://www.govtrack.us/congress/members/412539",
              "last_name": null,
              "latitude": 38.8863,
              "longitude": -77.0114,
              "maplight": "1763",
              "maplight_url": "http://maplight.org/us-congress/legislator/1763",
              "middle_name": "W.",
              "name": "Susan Brooks",
              "name_slug": "susan-brooks",
              "name_suffix": "Susan",
              "openly_lgbtq": "no",
              "opensecrets": "N00033495",
              "opensecrets_url": "https://www.opensecrets.org/politicians/summary.php?cid=N00033495",
              "opensecrets_url_tabs": {
                "summary": "https://www.opensecrets.org/politicians/summary.php?cid=N00033495",
                "elections": "https://www.opensecrets.org/politicians/elections.php?cid=N00033495",
                "industries": "https://www.opensecrets.org/politicians/industries.php?cid=N00033495",
                "pacs": "https://www.opensecrets.org/politicians/pacs.php?cid=N00033495",
                "donors": "https://www.opensecrets.org/politicians/contrib.php?cid=N00033495",
                "geography": "https://www.opensecrets.org/politicians/geog.php?cid=N00033495",
                "expenditures": "https://www.opensecrets.org/politicians/expend.php?cid=N00033495",
                "legislation": "https://www.opensecrets.org/politicians/bills.php?cid=N00033495",
                "news": "https://www.opensecrets.org/politicians/inthenews.php?cid=N00033495",
                "other": "https://www.opensecrets.org/politicians/otherdata.php?cid=N00033495"
              },
              "party": "republican",
              "phone": "202-225-2276",
              "photo_url": "https://cdn.civil.services/us-house/headshots/512x512/susan-brooks.jpg",
              "photo_url_sizes": {
                "64x64": "https://cdn.civil.services/us-house/headshots/64x64/susan-brooks.jpg",
                "128x128": "https://cdn.civil.services/us-house/headshots/128x128/susan-brooks.jpg",
                "256x256": "https://cdn.civil.services/us-house/headshots/256x256/susan-brooks.jpg",
                "512x512": "https://cdn.civil.services/us-house/headshots/512x512/susan-brooks.jpg",
                "1024x1024": "https://cdn.civil.services/us-house/headshots/1024x1024/susan-brooks.jpg"
              },
              "pronunciation": "SOO-zin BROOKS",
              "religion": "roman-catholic",
              "state_code": "IN",
              "state_code_slug": "in",
              "state_name": "Indiana",
              "state_name_slug": "indiana",
              "term_end": "2019-01-03T00:00:00.000Z",
              "thomas": "2129",
              "title": "representative",
              "twitter_handle": "SusanWBrooks",
              "twitter_url": "https://twitter.com/SusanWBrooks",
              "vacant": false,
              "votesmart": "135988",
              "votesmart_url": "http://votesmart.org/candidate/135988",
              "votesmart_url_tabs": {
                "summary": "http://votesmart.org/candidate/135988",
                "bio": "http://votesmart.org/candidate/biography/135988",
                "votes": "http://votesmart.org/candidate/key-votes/135988",
                "positions": "http://votesmart.org/candidate/political-courage-test/135988",
                "ratings": "http://votesmart.org/candidate/evaluations/135988",
                "speeches": "http://votesmart.org/candidate/public-statements/135988",
                "funding": "http://votesmart.org/candidate/campaign-finance/135988"
              },
              "website": "https://susanwbrooks.house.gov",
              "wikidata": "Q3225324",
              "wikidata_url": "https://www.wikidata.org/wiki/Q3225324"
            },
            {
              "address_city": "Washington",
              "address_complete": "2436 Rayburn Hob, Washington, DC 20515",
              "address_number": "2436",
              "address_prefix": null,
              "address_sec_unit_num": null,
              "address_sec_unit_type": null,
              "address_state": "DC",
              "address_street": "Rayburn Hob",
              "address_type": null,
              "address_zipcode": "20515",
              "age": 72,
              "at_large": false,
              "biography": "Susan Davis, a Representative from California; born in Cambridge, Middlesex County, Mass., April 13, 1944; B.A., University of California, Berkeley, Calif., 1965; M.S.W., University of North Carolina, Chapel Hill, N.C., 1968; member of the San Diego, Calif., board of education, 1983-1992, president, San Diego, Calif., board of education 1989-1992; executive director, Aaron Price Fellows, 1990-1994; member of the California state assembly, 1994-2000; elected as a Democrat to the One Hundred Seventh and to the eight succeeding Congresses (January 3, 2001-present).",
              "bioguide": "D000598",
              "bioguide_url": "http://bioguide.congress.gov/scripts/biodisplay.pl?index=D000598",
              "contact_page": "https://susandavis.house.gov/contact",
              "date_of_birth": "1944-04-13T00:00:00.000Z",
              "district": 53,
              "entered_office": "2001-01-03T00:00:00.000Z",
              "ethnicity": "white-american",
              "facebook_url": "https://www.facebook.com/RepSusanDavis/",
              "fax": "202-225-2948",
              "fec": "H0CA49055",
              "fec_url": "http://www.fec.gov/fecviewer/CandidateCommitteeDetail.do?candidateCommitteeId=H0CA49055",
              "first_name": "Susan",
              "gender": "female",
              "goes_by": null,
              "google_entity_id": "kg:/m/024xs5",
              "govtrack": "400097",
              "govtrack_url": "https://www.govtrack.us/congress/members/400097",
              "last_name": null,
              "latitude": 38.8863,
              "longitude": -77.0114,
              "maplight": "207",
              "maplight_url": "http://maplight.org/us-congress/legislator/207",
              "middle_name": null,
              "name": "Susan Davis",
              "name_slug": "susan-davis",
              "name_suffix": "Susan",
              "openly_lgbtq": "no",
              "opensecrets": "N00009604",
              "opensecrets_url": "https://www.opensecrets.org/politicians/summary.php?cid=N00009604",
              "opensecrets_url_tabs": {
                "summary": "https://www.opensecrets.org/politicians/summary.php?cid=N00009604",
                "elections": "https://www.opensecrets.org/politicians/elections.php?cid=N00009604",
                "industries": "https://www.opensecrets.org/politicians/industries.php?cid=N00009604",
                "pacs": "https://www.opensecrets.org/politicians/pacs.php?cid=N00009604",
                "donors": "https://www.opensecrets.org/politicians/contrib.php?cid=N00009604",
                "geography": "https://www.opensecrets.org/politicians/geog.php?cid=N00009604",
                "expenditures": "https://www.opensecrets.org/politicians/expend.php?cid=N00009604",
                "legislation": "https://www.opensecrets.org/politicians/bills.php?cid=N00009604",
                "news": "https://www.opensecrets.org/politicians/inthenews.php?cid=N00009604",
                "other": "https://www.opensecrets.org/politicians/otherdata.php?cid=N00009604"
              },
              "party": "democrat",
              "phone": "202-225-2040",
              "photo_url": "https://cdn.civil.services/us-house/headshots/512x512/susan-davis.jpg",
              "photo_url_sizes": {
                "64x64": "https://cdn.civil.services/us-house/headshots/64x64/susan-davis.jpg",
                "128x128": "https://cdn.civil.services/us-house/headshots/128x128/susan-davis.jpg",
                "256x256": "https://cdn.civil.services/us-house/headshots/256x256/susan-davis.jpg",
                "512x512": "https://cdn.civil.services/us-house/headshots/512x512/susan-davis.jpg",
                "1024x1024": "https://cdn.civil.services/us-house/headshots/1024x1024/susan-davis.jpg"
              },
              "pronunciation": "SOO-zuhn DAY-viss",
              "religion": "jewish",
              "state_code": "CA",
              "state_code_slug": "ca",
              "state_name": "California",
              "state_name_slug": "california",
              "term_end": "2019-01-03T00:00:00.000Z",
              "thomas": "1641",
              "title": "representative",
              "twitter_handle": "RepSusanDavis",
              "twitter_url": "https://twitter.com/RepSusanDavis",
              "vacant": false,
              "votesmart": "8168",
              "votesmart_url": "http://votesmart.org/candidate/8168",
              "votesmart_url_tabs": {
                "summary": "http://votesmart.org/candidate/8168",
                "bio": "http://votesmart.org/candidate/biography/8168",
                "votes": "http://votesmart.org/candidate/key-votes/8168",
                "positions": "http://votesmart.org/candidate/political-courage-test/8168",
                "ratings": "http://votesmart.org/candidate/evaluations/8168",
                "speeches": "http://votesmart.org/candidate/public-statements/8168",
                "funding": "http://votesmart.org/candidate/campaign-finance/8168"
              },
              "website": "https://susandavis.house.gov",
              "wikidata": "Q460675",
              "wikidata_url": "https://www.wikidata.org/wiki/Q460675"
            }
          ],
          "attribution": {
            "text": "Data Provided by Civil Services",
            "website": "https://civil.services",
            "link": "<a href=\"https://civil.services\">Data Provided by Civil Services</a>",
            "license": "https://raw.githubusercontent.com/CivilServiceUSA/api/master/LICENSE",
            "logo": "https://cdn.civil.services/common/logo.png",
            "icon": "https://cdn.civil.services/common/icon.png"
          }
        }