Commands

Every command, argument and option of dip 0.0.9, read from the CLI itself.

Global options

These options work with every command.

Option	Description	Default
`-V, --version`	output the version number
`--base-url <url>`	API base URL	`https://search.dip.bundestag.de`
`--api-key <key>`	DIP API key (prefer the DIP_API_KEY env var; a flag is visible in ps/history)
`--timeout <ms>`	time limit per request in milliseconds, whole response included
`--user-agent <ua>`	User-Agent header value
`--max-retries <n>`	retries for transient 429/503 responses
`--max-response-bytes <n>`	cap response body size in bytes (0 = unlimited; default 100 MiB)
`--compact`	print JSON on a single line instead of pretty-printed
`-o, --output <file>`	for downloads: write bytes to this file instead of stdout
`--force`	with -o, overwrite the output file if it already exists

`dip obtain-key`

Obtain the DIP API key and check it still works. DIP rotates its published key, so the candidate is verified against the live API before it is printed; if no published key is accepted the command fails and points at https://dip.bundestag.de/über-dip/hilfe/api.

dip obtain-key [options]

Options

Option	Description	Default
`--export`	print "export DIP_API_KEY=<key>" for use with eval
`--no-verify`	skip the live check and print the published candidate unchecked

`dip vorgang`

Vorgänge (procedures)

`dip vorgang list`

List/filter vorgang

dip vorgang list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip vorgang get`

Get one vorgang by id

dip vorgang get [options] <id>

Arguments

<id> required

`dip vorgangsposition`

Vorgangspositionen

`dip vorgangsposition list`

List/filter vorgangsposition

dip vorgangsposition list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip vorgangsposition get`

Get one vorgangsposition by id

dip vorgangsposition get [options] <id>

Arguments

<id> required

`dip drucksache`

Drucksachen (printed papers)

`dip drucksache list`

List/filter drucksache

dip drucksache list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip drucksache get`

Get one drucksache by id

dip drucksache get [options] <id>

Arguments

<id> required

`dip drucksache-text`

Drucksachen with full text

`dip drucksache-text list`

List/filter drucksache-text

dip drucksache-text list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip drucksache-text get`

Get one drucksache-text by id

dip drucksache-text get [options] <id>

Arguments

<id> required

`dip plenarprotokoll`

Plenarprotokolle

`dip plenarprotokoll list`

List/filter plenarprotokoll

dip plenarprotokoll list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip plenarprotokoll get`

Get one plenarprotokoll by id

dip plenarprotokoll get [options] <id>

Arguments

<id> required

`dip plenarprotokoll-text`

Plenarprotokolle with full text

`dip plenarprotokoll-text list`

List/filter plenarprotokoll-text

dip plenarprotokoll-text list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip plenarprotokoll-text get`

Get one plenarprotokoll-text by id

dip plenarprotokoll-text get [options] <id>

Arguments

<id> required

`dip aktivitaet`

Aktivitäten

`dip aktivitaet list`

List/filter aktivitaet

dip aktivitaet list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip aktivitaet get`

Get one aktivitaet by id

dip aktivitaet get [options] <id>

Arguments

<id> required

`dip person`

Personen (members)

`dip person list`

List/filter person

dip person list [options]

Options

Option	Description	Default
`--cursor <cursor>`	pagination cursor from a previous page
`--id <id>`	filter by id (repeatable -> f.id)
`--filter <key=value>`	raw DIP filter, e.g. f.titel=Klima (repeatable)

`dip person get`

Get one person by id

dip person get [options] <id>

Arguments

<id> required