> ## Documentation Index > Fetch the complete documentation index at: https://docs.grainfinance.co/llms.txt > Use this file to discover all available pages before exploring further. # List Spots > Retrieves all spot transactions for the given organization. This endpoint is deprecated and will be removed on **Jul 15**. Use [`GET /conversions`](/api-reference/conversions/list-conversions) instead. ## OpenAPI ````yaml GET /spots openapi: 3.1.0 info: title: Grain API version: 1.0.0 description: >- Grain's API provides a comprehensive set of endpoints for managing hedging, spot transactions, pricing, and fund movements - enabling seamless integration of FX workflows into your platform. Each API call follows REST conventions, uses secure authentication, and returns standardized responses for consistency across environments. license: name: Creative Commons Attribution 3.0 contact: name: Grain Finance url: https://docs.grainfinance.co email: support@grainfinance.co termsOfService: https://grainfinance.co/terms-of-service/ x-apiClientRegistration: url: https://grainfinance.co/partners servers: - url: https://api.grainfinance.co/v1 description: Grain API security: [] tags: - name: Hedges description: >- Hedge objects represent transactions that lock exchange rates for future dates. A single hedge locks an exchange rate for a future transaction between two currencies. - name: Dual Hedges description: >- A dual hedge mitigates FX risk by automatically generating two linked hedge legs - a customer leg and a supplier leg - both routed through the customer's functional currency. This structure reduces exposure to currency fluctuations for both cash flow and accounting purposes, while allowing independent tracking and reporting of each hedge leg. - name: Customers description: >- Customer objects represent your end customers on the Grain platform. A customer must be created before a hedge or spot transaction can be initiated. - name: Pricing description: >- Pricing endpoints provide access to FX rates for currency pairs that are not being hedged. These endpoints can be used for live rate display or bulk retrieval to support high-volume quoting workflows. - name: Spots description: >- Spot objects represent currency conversions executed for immediate or near-term settlement. - name: Conversions description: >- Conversion objects represent currency conversions executed for immediate or near-term settlement. - name: Wallets description: Endpoints to view balances, manage funding, and perform transfers. paths: /spots: get: tags: - Spots description: Retrieves all spot transactions for the given organization. operationId: List parameters: - description: page number indicating which set of items to return in: query name: page required: false schema: $ref: '#/components/schemas/Page' - description: The number of items in a page in: query name: per_page required: false schema: $ref: '#/components/schemas/PerPage' responses: '200': description: Spot List for Organization content: application/json: schema: $ref: '#/components/schemas/ListSpotsResponseBody' '422': description: >- The request failed because it is either semantically incorrect or has failed business validation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - api-key: [] components: schemas: Page: type: number format: double description: The page indicating which set of items are returned minimum: 1 PerPage: type: number format: double description: number of items in a page minimum: 1 maximum: 100 ListSpotsResponseBody: properties: spots: items: $ref: '#/components/schemas/OrganizationSpot' type: array description: A list of spots matching the search criteria. pagination: $ref: '#/components/schemas/PaginationResponse' required: - spots - pagination type: object additionalProperties: false ErrorResponse: description: An API Error properties: message: type: string description: A short explanation of the error. example: Can't perform this action reason: type: string description: A detailed description of the reason for the failure. example: >- Supplied object is in *Cancelled* state, which prevents performing this action required: - message type: object additionalProperties: false OrganizationSpot: properties: id: $ref: '#/components/schemas/UUID' description: The id of the spot within the Grain platform. example: 8173b9a7-ee61-413e-b9e3-7c04b2a067c5 organizationId: $ref: '#/components/schemas/UUID' description: >- The id of the organization that perform the spot within the Grain platform. example: 8173b9a7-ee61-413e-b9e3-7c04b2a067c5 fromCurrency: type: string description: >- The currency in which the transaction should be paid at by your customer. example: MXN toCurrency: type: string description: >- The currency in which the inventory item is listed at on your platform. example: USD toCurrencyAmount: type: number format: double description: The amount to transfer in the toCurrency example: 1560 fromCurrencyAmount: type: number format: double description: The amount to transfer in the fromCurrency example: 32161.8 quote: type: number format: double description: The rate locked by this spot. example: 20.6165 acceptedAtTs: type: number format: double description: The unix timestamp in which the spot offer was accepted (if it was). example: 1659625088 issuedAt: $ref: '#/components/schemas/GrainDateFormat' description: >- The date in which the spot was issued, denoted in `YYYY-MM-DD` format. example: '2023-01-18' completedAt: description: >- The date in which the spot was completed, denoted in `YYYY-MM-DD` format. example: '2023-02-23' oneOf: - $ref: '#/components/schemas/GrainDateFormat' - type: 'null' required: - id - organizationId - fromCurrency - toCurrency - toCurrencyAmount - fromCurrencyAmount - quote - acceptedAtTs - issuedAt - completedAt type: object additionalProperties: false PaginationResponse: description: Pagination parameters of the returned results. properties: page: $ref: '#/components/schemas/Page' perPage: $ref: '#/components/schemas/PerPage' totalResults: type: number format: double description: The total amount of results available required: - page - perPage - totalResults type: object additionalProperties: false UUID: type: string format: uuid description: |- Stringified UUIDv4. See [RFC 4112](https://tools.ietf.org/html/rfc4122) pattern: >- [0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12} GrainDateFormat: type: string example: '2023-04-15' format: YYYY-MM-DD description: >- The date format accepted by Grain's API. We accept dash separated ISO-8601 date-only strings. pattern: \d{4}-\d{2}-\d{2} securitySchemes: api-key: type: http scheme: basic description: >- Basic authentication using the partner API keys from https://console.grainfinance.co/keys ````