Skip to contents

Get a DIP Person

Usage

dip_bundestag_person(person_id, params = list(), safe = TRUE, refresh = FALSE)

Arguments

person_id

Person id.

params

Named list of query parameters. Common keys:

format

Response format ("json" recommended; default set by adapter).

apikey

Optional API key as query parameter (prefer auth header).

fuzzy

Free-text search string (character).

sort

Sort field/order definition (character).

cursor

Cursor for pagination (character).

limit

Page size/maximum number of documents (integer).

safe

Logical; if TRUE (default), apply rate-limiting and cache GET responses to tools::R_user_dir("bunddev", "cache").

refresh

Logical; if TRUE, ignore cached responses and re-fetch from the API (default FALSE).

Value

A one-row tibble for the selected person:

id

Person identifier (character).

nachname

Last name (character).

vorname

First name (character).

namenszusatz

Name affix, e.g. "von der" (character or NA).

typ

Entity type, always "Person" (character).

wahlperiode

Legislative period of first associated document (integer or NA).

basisdatum

Date of first associated document (character or NA).

datum

Date of most recent associated document (character or NA).

aktualisiert

Last update timestamp (character, ISO datetime).

titel

Display title with role (character).

person_roles

Roles and alternative names (list-column).

Examples

if (FALSE) { # \dontrun{
dip_bundestag_person(1728)
} # }