List the organization Assets
Lists the active organization’s Assets, newest first. Each row carries its Registrations, so one read answers where every file is and what still needs registering. A reservation is excluded until finalize promotes it to ready, and so is a deleted Asset.
One page at a time: limit rows at most, 100 by default. When the answer holds nextCursor, more rows exist: send it back as cursor to get the next page. There is no filter.
/assetsAuthorizationBearer token · headerrequiredSend Authorization: Bearer <credential>.
Use an API key (acr_…), from the AdCrunch console under Settings → API keys.
The credential names the organization, and no operation takes an organization parameter.
See https://docs.adcrunch.dev/api/authentication.
cursorstringlimitintegerrequiredOne page of the stored Assets of the organization, newest first, each with its Registrations. An Asset registered nowhere carries an empty array. This page is the last one, so it carries no nextCursor.
dataobject[]requiredShow propertiesHide properties
objectcontentHashstringrequiredAdCrunch’s own hash of the stored bytes. A hint for de-duplication, never an identity, and never a provider’s hash. Empty when the store reports none.
createdAtnumberrequiredMilliseconds since the Unix epoch, UTC.
createdBystringrequiredThe user who reserved the upload.
deletedAtnumber | nullrequiredAlways null here. A deleted Asset is not answered.
durationMsnumber | nullrequiredHow long the video runs, in milliseconds, read from the header of the file at finalize. null for an image. For a video, null when the file does not state it, or for an Asset uploaded before AdCrunch read it.
filenamestringrequiredThe name the file was uploaded under. Never a lookup key.
heightnumber | nullrequiredThe height in pixels as the file is displayed, with its rotation applied, read from the header of the file at finalize. null when the file does not state it, or for an Asset uploaded before AdCrunch read it.
idstringrequiredkeystringrequiredWhere the bytes are held. Read-only, and never sent by you.
kindstringrequiredFollows from mimeType, so the stored bytes verify it at finalize. It selects how a provider takes the file.
imagevideomimeTypestringrequiredThe Content-Type the file was uploaded with, verified against the stored bytes at finalize.
namestring | nullrequiredThe name a person gave this Asset, and what a provider receives at a future registration. null until somebody renames it, and the filename is the fallback.
organizationIdstringrequiredsizeBytesnumberrequiredRead from the stored object at finalize.
statusstringrequiredready once the bytes have been inspected. A pending Asset is a reservation whose bytes have not arrived, and no operation here answers one.
pendingreadyupdatedAtnumber | nullrequiredMilliseconds since the Unix epoch, UTC.
widthnumber | nullrequiredThe width in pixels as the file is displayed, with its rotation applied, read from the header of the file at finalize. null when the file does not state it, or for an Asset uploaded before AdCrunch read it.
registrationsobject[]requiredEvery advertiser this Asset has been placed with, and how each Registration went. An empty array means it is stored and registered nowhere.
Show propertiesHide properties
objectadvertiserIdstringrequiredThe advertiser whose library holds the bytes.
assetIdstringrequiredcreatedAtnumberrequiredMilliseconds since the Unix epoch, UTC.
deletedAtnumber | nullrequiredSet when a failed attempt was tombstoned to free the pair for a retry. null on a live Registration.
failureReasonstring | nullrequiredThe provider’s own code and message. Only set on a failure.
idstringrequiredorganizationIdstringrequiredproviderstringrequiredThe provider that owns the advertiser.
metagadstiktokxopenaisnapchatdv360providerIdentifierstring | nullrequiredWhat the provider gave back — a Meta image hash or video id. null until the Registration is ready. This is the id a creative is built with.
statusstringrequiredVideo can stay running for several minutes while the provider processes it. That is normal, and not a failure.
runningreadyfailedupdatedAtnumber | nullrequiredMilliseconds since the Unix epoch, UTC.
uploadSessionIdstring | nullrequiredAn in-flight provider upload session, where the protocol has one. null for every image.
workflowIdstringrequiredThe durable execution that placed it.
nextCursorstringSend this value as cursor to get the next page. It is absent on the last page.
The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. error is invalid_request, and issues names each field. Nothing was changed. Or AdCrunch cannot use the cursor: it cannot read it, or the cursor belongs to a different query. Then error is invalid_cursor. Send the nextCursor of the previous page with no change, or omit cursor to get the first page.
issuesobject[]requiredOne entry for each field that does not match.
Show propertiesHide properties
objectinstringrequiredThe part of the request that holds the field.
bodycookieheadersparamsquerymessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
pathstringrequiredA JSON Pointer into that part of the request, such as /filename. An empty string is the whole part.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
invalid_requestmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
invalid_cursormessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
No API key, or one that does not resolve. See the security scheme. error is unauthorized.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
unauthorizedmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.
The caller does not hold asset:read. error is forbidden.
errorstringrequiredA stable code for the failure. This is the field to branch on. It does not change for a given failure.
forbiddenmessagestringrequiredA sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.