Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: KeyVex Photos API
version: 0.102.0
termsOfService: https://keyvex.com/terms
description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Photos
paths:
/v1/photos/{bioguideId}:
get:
operationId: get_member_photo
summary: Congressional member photo (JPEG)
description: Official portrait of a member of Congress as a JPEG, keyed by bioguide ID. Self-hosted mirror of the public-domain congressional portrait collection (450x550), or, for a member that collection does not have yet, the member's portrait from the U.S. Government Publishing Office's Pictorial Directory, the official source that collection is built from (sizes vary; none over 1.5 MB). Pairs with get_member_profile, whose photo_url field points here. All plans, Free included. Each photo counts as 3 calls toward the daily allowance; the Free plan allows 2 photos a day. A member with no portrait in either source returns 404.
parameters:
- name: bioguideId
in: path
required: true
description: Member's bioguide ID, e.g. P000197 (Nancy Pelosi).
schema:
type: string
pattern: ^[A-Z][0-9]{6}$
responses:
'200':
description: JPEG image.
content:
image/jpeg:
schema:
type: string
format: binary
'401':
description: Missing or invalid API key.
'402':
description: This tool requires a higher plan (upgrade_required). Retrying will not help.
'404':
description: No photo for this member.
'429':
description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
tags:
- Photos
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key