Buyer API
Generated from the buyer API's own description of itself.
DataDrop buyer API, version 2.0.0.
listings
GET /v2/listings/browse/purchases
List Buyer Purchase History
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Parameter | In | Type | Required |
|---|---|---|---|
query | query | string or null | no |
tags | query | array of string or null | no |
tag_slugs | query | array of string or null | no |
asset_types | query | array of string or null | no |
owned | query | boolean | no |
verified_only | query | boolean | no |
min_price | query | number or null | no |
max_price | query | number or null | no |
min_tasks | query | integer or null | no |
max_tasks | query | integer or null | no |
min_price_per_task | query | number or null | no |
max_price_per_task | query | number or null | no |
min_loc | query | integer or null | no |
max_loc | query | integer or null | no |
min_zip_files | query | integer or null | no |
max_zip_files | query | integer or null | no |
min_zip_size_gb | query | number or null | no |
max_zip_size_gb | query | number or null | no |
min_codebases | query | integer or null | no |
max_codebases | query | integer or null | no |
min_environments | query | integer or null | no |
max_environments | query | integer or null | no |
min_robotics_datasets | query | integer or null | no |
max_robotics_datasets | query | integer or null | no |
min_raw_data | query | integer or null | no |
max_raw_data | query | integer or null | no |
min_commits | query | integer or null | no |
max_commits | query | integer or null | no |
min_pull_requests | query | integer or null | no |
max_pull_requests | query | integer or null | no |
min_contributors | query | integer or null | no |
max_contributors | query | integer or null | no |
languages | query | array of string or null | no |
rare_languages_only | query | boolean | no |
file_extensions | query | array of string or null | no |
robotics_formats | query | array of string or null | no |
capabilities | query | array of string or null | no |
org | query | string or null | no |
sort | query | string | no |
limit | query | integer | no |
cursor | query | string or null | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/listings/browse/access
Get Browse Access
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Parameter | In | Type | Required |
|---|---|---|---|
ids | query | array of string (uuid) or null | no |
sort | query | string | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/listings/browse/{listing_id}
Browse Listing Detail
| Parameter | In | Type | Required |
|---|---|---|---|
listing_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/listings/browse/{listing_id}/quality
Browse Listing Quality
| Parameter | In | Type | Required |
|---|---|---|---|
listing_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/listings/browse/{listing_id}/tasksets/{taskset_id}
Browse Listing Taskset
| Parameter | In | Type | Required |
|---|---|---|---|
listing_id | path | string (uuid) | yes |
taskset_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/listings/browse/{listing_id}/tasksets/{taskset_id}/tasks
Browse Listing Taskset Tasks
| Parameter | In | Type | Required |
|---|---|---|---|
listing_id | path | string (uuid) | yes |
taskset_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
asset-types
GET /v2/asset-types
List Asset Types
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Parameter | In | Type | Required |
|---|---|---|---|
slug | path | string | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
domains
GET /v2/domains
List Domains
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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
| Parameter | In | Type | Required |
|---|---|---|---|
status | query | string or null | no |
offset | query | integer | no |
limit | query | integer | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable 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
| Parameter | In | Type | Required |
|---|---|---|---|
opportunity_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable 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
| Parameter | In | Type | Required |
|---|---|---|---|
opportunity_id | path | string (uuid) | yes |
offset | query | integer | no |
limit | query | integer | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/buyer/opportunities
List Opportunities
| Parameter | In | Type | Required |
|---|---|---|---|
status | query | string or null | no |
offset | query | integer | no |
limit | query | integer | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/buyer/opportunities/{opportunity_id}
Get Opportunity
| Parameter | In | Type | Required |
|---|---|---|---|
opportunity_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
notifications
GET /v2/vendor/notifications
List Notifications
| Parameter | In | Type | Required |
|---|---|---|---|
view | query | NotificationView | no |
limit | query | integer | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
opportunities
GET /v2/opportunities
List Opportunities
| Parameter | In | Type | Required |
|---|---|---|---|
query | query | string or null | no |
tags | query | array of string or null | no |
asset_types | query | array of string or null | no |
max_budget | query | number or null | no |
budget_unit | query | string or null | no |
sort | query | string | no |
offset | query | integer | no |
limit | query | integer | no |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
GET /v2/opportunities/{opportunity_id}
Get Opportunity
| Parameter | In | Type | Required |
|---|---|---|---|
opportunity_id | path | string (uuid) | yes |
| Status | Meaning |
|---|---|
200 | Successful Response |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
503 | Service 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. |
422 | Unprocessable Entity |
Not available yet
GET /v2/wallet
Not available yet: arrives with Ember Data's credit balance.