Browse artist credits

GET

/v1/artists

const url = 'https://api.digirare.com/v1/artists?limit=50&sort=name';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.digirare.com/v1/artists?limit=50&sort=name'

Browse effective artist credits, including curated corrections. Counts deduplicate assets across collections. Defaults to name order; artworks order can be used for a featured selection. Credits and artwork counts do not verify artist identity.

Parameters

Query Parameters

limit

integer

default: 50 >= 1 <= 100

Maximum rows in this page.

cursor

string

<= 200 characters

Continuation returned as next_cursor. Keep the same filters between pages.

string

<= 200 characters

Substring search; ASCII case-insensitive.

letter

string

/^([A-Z]|#)?$/

First character of the current display name, ASCII case-insensitive. # includes numbers, symbols and names outside A–Z. Omit for all initials.

sort

string

default: name

Allowed values: name artworks

Sort by ASCII case-insensitive display name, or descending distinct credited artwork count with name and id as tie-breakers. Keep the same sort between pages.

Responses

200

ArtistList

application/json

object

result

required

Array<object>

object

name

required

string

key

required

string

assets

required

integer

collections

required

integer

required

string

preview_assets

required

Up to eight distinct artworks sampled across collections, using effective artist attribution.

Array<object>

<= 8 items

object

asset

required

string

asset_longname

required

string | null

issued_year

required

integer | null

media_kind

required

string | null

Allowed values: image animation video html svg

protocol_subtype

required

string | null

collection

required

string

collection_name

required

string

art_frame

required

string

Allowed values: card square landscape

result_count

required

integer

next_cursor

required

string | null

Example

{
  "result": [
    {
      "preview_assets": [
        {
          "media_kind": "image",
          "art_frame": "card"
        }
      ]
    }
  ]
}

400

Stable machine-readable failure

application/json

object

error

required

string

code

required

string

Allowed values: invalid_request unsupported_address_type unauthenticated forbidden not_found method_not_allowed state_changed expired invalid_transaction rate_limited internal_error upstream_unavailable service_unavailable checkout_changed target_unavailable signature_invalid template_mismatch mempool_rejected broadcast_unknown conflict_spend duplicate_funding_slot offer_selection_unavailable attached_delivery_single_item_only insufficient_funds insufficient_asset_balance price_below_minimum listing_price_above_maximum counter_price_invalid self_trade offer_capacity_full open_offer_limit policy_offer_refused

retryable

boolean

mempool_policy

On 422 mempool_rejected from a broadcast: which deterministic node policy refused the bytes. Retrying the same bytes fails the same way. fee_floor: re-quote at a higher fee_rate. chain_too_long: too many unconfirmed ancestors; wait for a confirmation, then retry. truc: a version-3 (TRUC) package rule, such as spending an unconfirmed version-3 output; wait for a confirmation, then retry.

string

Allowed values: fee_floor chain_too_long truc dust nonstandard

mempool_reason

The node’s own reject reason, on mempool_rejected (422) and on state_changed (409) when a broadcast lost to a conflicting or replacing spend.

string

wait_for_confirmation

Present and true when mempool_policy is chain_too_long or truc.

boolean

claims_released

On a checkout or accept completion refused as mempool_rejected: the journaled settlement ended and every listing, bid, and asset claim it held was released (its inputs were proven unspent). The quote or accept is replaced; request a new one.

boolean

refused_listings

Batch listing routes only: every refused item. The first sets the status and code.

Array<object>

One refused item in a batch refusal’s refused_listings array. Nothing in the batch was changed.

object

index

required

integer

listing_id

required

string

status

required

integer

code

required

string

error

required

string

key

additional properties

any

retry_after_seconds

On 429 rate_limited: the exact seconds until the oldest counted request leaves the window; a retry then is admitted (also sent as Retry-After). Limited writes are bucketed per route scope in exact sliding 60-second windows: by session address when a valid x-session-token is present, otherwise by IP, with a per-IP ceiling across sessions. Expensive writes: 20, ceiling 120. Signed completions: 120, ceiling 600. Session minting (/auth/*): 60 per IP. A request refused by any bucket is counted by none.

integer

>= 1

key

additional properties

any

Example

{
  "code": "invalid_request",
  "mempool_policy": "fee_floor"
}

404

Stable machine-readable failure

application/json

object

error

required

string

code

required

string

retryable

boolean

mempool_policy

string

Allowed values: fee_floor chain_too_long truc dust nonstandard

mempool_reason

The node’s own reject reason, on mempool_rejected (422) and on state_changed (409) when a broadcast lost to a conflicting or replacing spend.

string

wait_for_confirmation

Present and true when mempool_policy is chain_too_long or truc.

boolean

claims_released

boolean

refused_listings

Batch listing routes only: every refused item. The first sets the status and code.

Array<object>

One refused item in a batch refusal’s refused_listings array. Nothing in the batch was changed.

object

index

required

integer

listing_id

required

string

status

required

integer

code

required

string

error

required

string

key

additional properties

any

retry_after_seconds

integer

>= 1

key

additional properties

any

Example

{
  "code": "invalid_request",
  "mempool_policy": "fee_floor"
}