RIPE Atlas Documentation

GET /measurements/{msm}/participation-requests/ ​

Retrieve all participation requests for a measurement

GET /measurements/{msm}/participation-requests/ — after ​

Used to get the next page of results when the maximum page number has been reached.

GET /measurements/{msm}/participation-requests/ — fields ​

Comma-separated list of fields to include in response, in addition to 'type' and 'id' which are always present. Optional fields can be listed here also.

GET /measurements/{msm}/participation-requests/ — format[datetime] ​

Output datetimes in ISO-8601 format ('iso-8601' or 'json') or as seconds since the epoch ('unix' or 'timestamp')

GET /measurements/{msm}/participation-requests/ — msm ​

The unique measurement ID.

GET /measurements/{msm}/participation-requests/ — optional_fields ​

Comma-separated list of optional fields named to include in response objects.

GET /measurements/{msm}/participation-requests/ — page_size ​

Set the number of measurements returned on one page. Maximum size is 500, default is 50.

GET /api/v2/measurements/{msm}/participation-requests/​

Retrieve all participation requests for a measurement

Try it out

Playground​

Authorization
Variables
Key
Value
Authorizations

Authorizations​

api-key
Type
API Key (header: Authorization)
or
ripe-access
Type
API Key (cookie: crowd.token_key)
or
anonymous

No authentication required — this endpoint can be accessed anonymously.

Parameters

Path Parameters

msm*

The unique measurement ID.

Type
integer
Required

Query Parameters

after

Used to get the next page of results when the maximum page number has been reached.

Type
string
fields

Comma-separated list of fields to include in response, in addition to 'type' and 'id' which are always present. Optional fields can be listed here also.

Type
string
format[datetime]

Output datetimes in ISO-8601 format ('iso-8601' or 'json') or as seconds since the epoch ('unix' or 'timestamp')

Type
string
Valid values
"iso-8601""json""timestamp""unix"
optional_fields

Comma-separated list of optional fields named to include in response objects.

Type
string
Valid values
"measurement"
page_size

Set the number of measurements returned on one page. Maximum size is 500, default is 50.

Type
integer
Responses

Responses​

application/json
object
Format"uri"
Format"uri"
object[]
Required

Number of probes that have to be added or removed

Probe selector type.

  • area - Compass quarter of the world
  • country - ISO 3166-1 alpha-2 country code
  • probes - Comma-separated list of probe IDs
  • asn - Autonomous System Number
  • prefix - IPv4 or IPv6 Prefix
  • msm - Existing measurement ID
  • region - Pre-defined region name
  • countries - Comma-separated list of ISO 3166-1 alpha-2 country codes
Valid values"area""country""probes""asn""prefix""msm""region""countries"

Value for given selector type. area: 'WW', 'West', 'North-Central', 'South-Central', 'North-East', 'South-East'. asn: ASN (integer). country: two-letter country code according to ISO 3166-1 alpha-2, e.g. GR. msm: measurement ID (integer). prefix: prefix in CIDR notation, e.g. 193.0.0/16. probes: comma-separated list of probe IDs

Action to be applied, or that was applied to the measurement involved.'add': add probe to the measurement, 'remove': remove probe from the measurement

  • add - Add probes
  • remove - Remove probes
Valid values"add""remove"

Comma-separated list of probe tags. Only probes with all these tags attached will be selected from this participation request

Format"comma-separated tag list"

Comma-separated list of probe tags. Probes with any of these tags attached will be excluded from this participation request

Format"comma-separated tag list"

Additional information

The unique ID for this participation request

The creation date and time of the participations request (Defaults to unix timestamp format)

Format"date-time"

The (direct) URL of this participations request

Format"uri"
Samples