DataDrop
Buy

Buyer API

Generated from the buyer API's own description of itself.

Draft: not yet checked against the product

DataDrop buyer API, version 2.0.0.

listings

GET /v2/listings/browse/purchases

List Buyer Purchase History

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

GET /v2/listings/browse/offers

List Buyer Offer History

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

GET /v2/listings/browse

Browse Listings

ParameterInTypeRequired
queryquerystring or nullno
tagsqueryarray of string or nullno
tag_slugsqueryarray of string or nullno
asset_typesqueryarray of string or nullno
ownedquerybooleanno
verified_onlyquerybooleanno
min_pricequerynumber or nullno
max_pricequerynumber or nullno
min_tasksqueryinteger or nullno
max_tasksqueryinteger or nullno
min_price_per_taskquerynumber or nullno
max_price_per_taskquerynumber or nullno
min_locqueryinteger or nullno
max_locqueryinteger or nullno
min_zip_filesqueryinteger or nullno
max_zip_filesqueryinteger or nullno
min_zip_size_gbquerynumber or nullno
max_zip_size_gbquerynumber or nullno
min_codebasesqueryinteger or nullno
max_codebasesqueryinteger or nullno
min_environmentsqueryinteger or nullno
max_environmentsqueryinteger or nullno
min_robotics_datasetsqueryinteger or nullno
max_robotics_datasetsqueryinteger or nullno
min_raw_dataqueryinteger or nullno
max_raw_dataqueryinteger or nullno
min_commitsqueryinteger or nullno
max_commitsqueryinteger or nullno
min_pull_requestsqueryinteger or nullno
max_pull_requestsqueryinteger or nullno
min_contributorsqueryinteger or nullno
max_contributorsqueryinteger or nullno
languagesqueryarray of string or nullno
rare_languages_onlyquerybooleanno
file_extensionsqueryarray of string or nullno
robotics_formatsqueryarray of string or nullno
capabilitiesqueryarray of string or nullno
orgquerystring or nullno
sortquerystringno
limitqueryintegerno
cursorquerystring or nullno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/listings/browse/access

Get Browse Access

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

GET /v2/listings/browse/by-ids

Browse Listings By Ids

ParameterInTypeRequired
idsqueryarray of string (uuid) or nullno
sortquerystringno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/listings/browse/{listing_id}

Browse Listing Detail

ParameterInTypeRequired
listing_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/listings/browse/{listing_id}/quality

Browse Listing Quality

ParameterInTypeRequired
listing_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/listings/browse/{listing_id}/tasksets/{taskset_id}

Browse Listing Taskset

ParameterInTypeRequired
listing_idpathstring (uuid)yes
taskset_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/listings/browse/{listing_id}/tasksets/{taskset_id}/tasks

Browse Listing Taskset Tasks

ParameterInTypeRequired
listing_idpathstring (uuid)yes
taskset_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

asset-types

GET /v2/asset-types

List Asset Types

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

GET /v2/asset-types/{slug}

Get Asset Type

ParameterInTypeRequired
slugpathstringyes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

domains

GET /v2/domains

List Domains

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

content-tags

GET /v2/content-tags

List Content Tags

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

inventory-tags

GET /v2/inventory-tags

List Inventory Tags

StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.

buyer

GET /v2/buyer/project-opportunities

Retired: DataDrop has no project opportunities: the list is always empty and every id is not found.

List Project Opportunities

ParameterInTypeRequired
statusquerystring or nullno
offsetqueryintegerno
limitqueryintegerno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/buyer/project-opportunities/{opportunity_id}

Retired: DataDrop has no project opportunities: the list is always empty and every id is not found.

Get Project Opportunity

ParameterInTypeRequired
opportunity_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/buyer/project-opportunities/{opportunity_id}/bids

Retired: DataDrop has no project opportunities: the list is always empty and every id is not found.

List Opportunity Bids

ParameterInTypeRequired
opportunity_idpathstring (uuid)yes
offsetqueryintegerno
limitqueryintegerno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/buyer/opportunities

List Opportunities

ParameterInTypeRequired
statusquerystring or nullno
offsetqueryintegerno
limitqueryintegerno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/buyer/opportunities/{opportunity_id}

Get Opportunity

ParameterInTypeRequired
opportunity_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

notifications

GET /v2/vendor/notifications

List Notifications

ParameterInTypeRequired
viewqueryNotificationViewno
limitqueryintegerno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

opportunities

GET /v2/opportunities

List Opportunities

ParameterInTypeRequired
queryquerystring or nullno
tagsqueryarray of string or nullno
asset_typesqueryarray of string or nullno
max_budgetquerynumber or nullno
budget_unitquerystring or nullno
sortquerystringno
offsetqueryintegerno
limitqueryintegerno
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

GET /v2/opportunities/{opportunity_id}

Get Opportunity

ParameterInTypeRequired
opportunity_idpathstring (uuid)yes
StatusMeaning
200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
503Service Unavailable. When the service is busy: the detail "The service is busy: nothing was changed. Try again in a few seconds." and a `Retry-After` header in seconds; send the same request again. This shape has no `reason` field: busy is told from another 503 by that detail.
422Unprocessable Entity

Not available yet

GET /v2/wallet

Not available yet: arrives with Ember Data's credit balance.

On this page