---
title: "Several fund files, computed"
method: GET
path: "/batch"
---

# Several fund files, computed

`GET /batch`

## Request

- Base URL: `https://tickerinside.com/api/v1`
- URL: `https://tickerinside.com/api/v1/batch`
- Auth: none required

Each fund as /fund/{ticker}.json answers it, keyed by ticker, with the tickers not covered and why. 1 to 10 funds. The files of the other layers composed in one call add up to at most 55 KB; the first is always composed.

## Query parameters

- `funds` string, required
- `format` 'json'

## Response `200`

The answer, computed when asked and kept in the edge cache for up to a day. The example is a real answer, shortened.

- Batch
  - `asked` string[], required: The tickers asked for, upper case, each once, in the order asked.
  - `found` integer, required: How many of them are in funds.
  - `not_covered` object[], required: The tickers with no fund file, each with error not_covered, ticker and message: reason has_security_file and security for one with a stock file, else reason no_file and fund, its own address, which gives the specific reason, and covered.
    - `error` 'not_covered', required
    - `ticker` string, required
    - `reason` 'has_security_file' | 'no_file'
    - `message` string, required
    - `security` string
    - `fund` string
    - `covered` string
  - `not_included` object[]: Funds of the other layers past what one call composes, each with ticker, fund, its own address, and reason over_budget. Absent when there is none.
    - `ticker` string, required
    - `fund` string, required
    - `reason` 'over_budget', required
  - `not_included_note` string: Why not_included is there.
  - `renamed` object: Each ticker of a fund renamed, with the ticker of the file served under it. Absent when there is none.
  - `funds` object, required: Each fund found, by ticker as asked: what /api/v1/fund/{ticker}.json answers, a fund file of the stock layers byte for byte, or the answer composed for a fund of another layer.
  - `license` string, required: The licence the data is published under.
  - `attribution` string, required: How to credit the data: a link to the page each fund file's cite_as names where the medium allows one, the name where it does not.
  - `docs` string, required: The reference of this endpoint.

## Other responses

- `304`: Not modified: the ETag of your copy, sent in If-None-Match, is still current.
- `400`: The query was refused: reason and parameter say what to fix, and limit and asked give the figures of a call past the limits.
- `405`: Another method than GET or HEAD.
- `503`: The answer could not be computed just then: retry after a minute.

---

[API](https://skmtc.dev/tickerinside/apis/tickerinside-api.md) · [All operations](https://skmtc.dev/tickerinside/apis/tickerinside-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerinside/apis/tickerinside-api/revisions/4dae3d8c4119?raw)