Skip to main content
POST
/
v1
/
scripts
/
batch
Batch resolve
curl --request POST \
  --url https://api.roscripts.io/v1/scripts/batch \
  --header 'Content-Type: application/json' \
  --data '
{
  "refs": [
    "<string>"
  ]
}
'
{
  "result.scripts": [
    {}
  ],
  "result.missing": [
    "<string>"
  ],
  "result.count": 123
}
Resolve up to 20 scripts (or 100 with an API key) in one request by id, slug, or shortId. Ideal for refreshing a known set — a user’s saved list, a curated hub, a local cache. 
curl -X POST "https://api.roscripts.io/v1/scripts/batch" \
  -H "Content-Type: application/json" \
  -d '{ "refs": ["blox-fruits-hub", "lst_9f2c…", "Ab3xK9q"] }'

​
Body

​
refs
string[]
required
Array of script ids, slugs, or shortIds. Max 20 anonymous, 100 with a key. Duplicates are de-duplicated.

​
Response

​
result.scripts
Script[]
The scripts that resolved (live only).
​
result.missing
string[]
Any refs that didn’t match a live script.
​
result.count
number
Number of scripts returned.
{
  "result": {
    "scripts": [
      { "id": "lst_…", "slug": "blox-fruits-hub", "loadstring": "https://script.roscripts.io/…" }
    ],
    "missing": ["Ab3xK9q"],
    "count": 1
  }
}
Batch is a POST, so it isn’t shared-cached at the edge. For browsing, prefer the cacheable GET list/search endpoints; reserve batch for resolving a specific known set.