# Grain Customers API

**Canonical:** https://apis.io/apis/grainfinance-co/grainfinance-co-customers-api/  
**Provider:** Grain — https://apis.io/providers/grainfinance-co/  
**Base URL:** https://api.grainfinance.co/v1  
**Documentation:** https://docs.grainfinance.co/api-reference/introduction

Grain Customers API is one of 9 APIs that [Grain](https://apis.io/providers/grainfinance-co/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Customer objects represent your end customers on the Grain platform. A customer must be created before a hedge or conversion can be initiated.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/customers` | Create |
| GET | `/customers` | List |
| POST | `/customers/{customerId}/update` | Update |
| GET | `/customers/{customerId}` | Get |
| DELETE | `/customers/{customerId}` | Delete |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/grainfinance-co/openapi/grainfinance-co-customers-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-get-dual-hedge-response-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-created-customer-hedge-proposal-response-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-accept-offline-dual-hedge-proposal-request-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-accept-offline-hedge-proposal-request-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-drawdown-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/grainfinance-co/json-schema/grainfinance-co-drawdown-proposal-response-schema.json

## Other Grain APIs (8)

- [Grain Conversions API](https://apis.io/apis/grainfinance-co/grainfinance-co-conversions-api/)
- [Grain Dual Hedges API](https://apis.io/apis/grainfinance-co/grainfinance-co-dual-hedges-api/)
- [Grain Grain API](https://apis.io/apis/grainfinance-co/grainfinance-co-grain-api-api/)
- [Grain Hedges API](https://apis.io/apis/grainfinance-co/grainfinance-co-hedges-api/)
- [Grain Payouts API](https://apis.io/apis/grainfinance-co/grainfinance-co-payouts-api/)
- [Grain Pricing API](https://apis.io/apis/grainfinance-co/grainfinance-co-pricing-api/)
- [Grain Vendors API](https://apis.io/apis/grainfinance-co/grainfinance-co-vendors-api/)
- [Grain Wallets API](https://apis.io/apis/grainfinance-co/grainfinance-co-wallets-api/)

## Tags

Customers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/grainfinance-co/grainfinance-co-customers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/grainfinance-co/.