Factset Returns API is one of 460 APIs that Factset publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 1 JSON Schema definition.
Tagged areas include Returns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, a changelog, and 1 JSON Schema.
This API exposes
15 operations
across 9 paths,
and defines 53 schemas.
It is described by OpenAPI 3.0.3, at version 1.0.0.
Requests are made against 2 base URLs: https://api.factset.com, https://api-sandbox.factset.com.
15 operations9 paths53 schemas9 GET6 POST
Metadata
The identity and technical contract details declared by the specification.
Factset Returns API declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (basicAuth).
By default, every request must be authenticated.
Paths & Operations 15
Across 9 paths, the API surfaces 15 operations — 9 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.
Returns 15
GET
/factset-funds/v1/returns
Factset Get Fund Returns for a Requested Time-series
getFundsReturns6 params→ 200400401403415500
POST
/factset-funds/v1/returns
Factset Get Fund Returns for a Requested Time-series and Large List of Ids
getFundsReturnsForListbody→ 200400401403415500
GET
/factset-funds/v1/returns-snapshot
Factset Get Fund Returns Over Pre-defined Time Horizons as of a Specific Date.
The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are returnsSnapshot_2 (22 properties), returnsSnapshot (12 properties), returnsRequest_2 (8 properties), returnsRequest (7 properties). Each schema is shown below with its type and property counts.
rollingPeriod
string
Period of measure for the rolling cumulative return. This does not change display frequency but rather the underlying return calculation period. All periods ar…
returns_2
object
5 properties
returnsResponse_2
object
1 property
batch
string
Enables the ability to asynchronously "batch" the request, supporting a long-running request for up to 20 minutes. Upon requesting batch=Y, the service will re…
ids
array
The requested Fund Identifier. FactSet Identifiers, tickers, CUSIP and SEDOL are accepted input. ids limit = 1000 per request Make note, GET Method URL request…
idsBatchMax10000
array
The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids. ids limit = 1000 per non-…
fundsReturnsSnapshotRequest
object
Returns Request Body
3 properties1 required
BatchStatus
object
5 properties
fundsReturnsRequest
object
Returns Request Body
6 properties1 required
currency
string
The ISO3 currency control for the requested fund.
returnsRangeResponse
object
1 property
ReturnType
object
2 properties
dividendAdjust_3
string
Controls the dividend reinvestment for the returns calculation. PRICE = Price Change - Dividends Excluded EXDATE = Simple Return - Dividends Received on exdate…
returnsSnapshot
object
12 properties
returns
object
5 properties
dateSnapshot
string
The date requested for a given date range in YYYY-MM-DD format. The date MUST be equal to or less than the priceRecentDate found within the /summary endpoint.
calendar
string
Calendar of data returned. SEVENDAY includes weekends. LOCAL calendar will default to the securities' trading calendar which excludes date records for respecti…
startDate_2
string
The start date requested for a given date range in YYYY-MM-DD format. Future dates (T+1) are not accepted in this endpoint.
startDate_3
string
The start date requested for a given date range in YYYY-MM-DD format. If left blank, the API will default to previous close. Future dates (T+1) are not accepte…
returnsRange
object
5 properties
returnsSnapshot_2
object
22 properties
ClientErrorResponse
object
1 property
dateRS
string
The date in YYYY-MM-DD format. This controls the perspective dates to the calculate the returns. If left blank, the API will default to previous close. Future…
returnsRangeRequest
object
Returns Range Request Body
4 properties1 required
BatchStatusResponse
object
1 property
frequency
string
Controls the display frequency of the data returned. D = Daily W = Weekly, based on the last day of the week of the start date. M = Monthly, based on the last…
endDate_2
string
The end date requested for a given date range in YYYY-MM-DD format. Future dates (T+1) are not accepted in this endpoint.
fundsReturnsResponse
object
1 property
readReturnsResponse
object
1 property
endDate
string
The end date requested for a given date range in YYYY-MM-DD format. If left blank, the API will default to previous close. Future dates (T+1) are not accepted…
SPARAccountsRoot
object
2 properties1 required
SPARAccounts
object
1 property
dividendAdjust
string
Controls the dividend inclusion for the NAV returns calculations, where - DIV = Include Dividends, Total Return NODIV = Exclude Dividends, Simple Return
returnsRequest_2
object
Returns Request Body
8 properties1 required
readReturnsCompositeResponse
object
1 property
Error
object
5 properties
startDateRange
string
The start date requested for a given date range in YYYY-MM-DD format. If left blank, the API will default to the day prior to today's previous close. The start…
startDate
string
The start date requested for a given date range in YYYY-MM-DD format. If left blank, the API will default to previous close. Future dates (T+1) are not accepte…
ErrorSource
object
2 properties
returnsSnapshotRequest
object
Returns Snapshot Request Body
5 properties1 required
returnsRequest
object
Returns Request Body
7 properties2 required
requestCurrency
string
Currency code for adjusting prices. Default is Local. For a list of currency ISO codes, visit [Online Assistant Page 1470](https://oa.apps.factset.com/pages/14…
dividendAdjustSnapshot
string
Controls the dividend reinvestment for the returns calculation. Dividends will be reinvested on the date the dividends go ex (when the dividends belong to the…
fundsReturnsSnapshotResponse
object
1 property
batchErrorObject
object
4 properties
dividendAdjust_2
string
Controls the dividend reinvestment for the returns calculation. PRICE = Price Change - Dividends Excluded. EXDATE = Simple Return - Dividends Received on exdat…
idsMax2000
array
The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids.
errorResponse
object
5 properties
frequency_2
string
Controls the display frequency of the data returned. D = Daily AD = Actual Daily W = Weekly, based on the last day of the week of the start date. M = Monthly,…
Errors
object
Information about one or more errors
1 property1 required
returnsSnapshotResponse
object
1 property
returnsResponse
object
1 property
return
object
6 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Factset Returns API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
