> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List varieties

> List varieties for a given admin crop.

```
GET https://www.wiseyield.co/api/v1/crop-library/varieties
```

### Authentication

Requires a key with the `library:read` scope.

### Query parameters

<ParamField query="adminCropId" type="string" required>UUID of the parent admin crop.</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of variety objects under the admin crop, ordered by `varietyName`.

  <Expandable title="Variety">
    <ResponseField name="id" type="string">UUID.</ResponseField>
    <ResponseField name="adminCropId" type="string">Parent admin crop UUID.</ResponseField>
    <ResponseField name="varietyName" type="string">Variety name (e.g. `"Medjool"`).</ResponseField>
    <ResponseField name="scientificName" type="string | null">Subspecific name if applicable.</ResponseField>
    <ResponseField name="description" type="string | null">Free text.</ResponseField>
    <ResponseField name="daysToMaturity" type="integer | null">Variety-specific maturity (overrides crop default).</ResponseField>
    <ResponseField name="yieldOverride" type="object | null">Variety-specific yield data.</ResponseField>
    <ResponseField name="climateOverride" type="object | null">Variety-specific climate tolerances.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://www.wiseyield.co/api/v1/crop-library/varieties?adminCropId=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee' \
    -H "Authorization: Bearer $WISEYIELD_API_KEY"
  ```
</RequestExample>

## Errors

| Status                    | When                                            |
| ------------------------- | ----------------------------------------------- |
| `400 VALIDATION_ERROR`    | `adminCropId` not provided                      |
| `400 INVALID_ID`          | `adminCropId` not a valid UUID                  |
| `401`                     | Missing, malformed, expired, or revoked API key |
| `403 INSUFFICIENT_SCOPE`  | Key lacks `library:read` scope                  |
| `429 RATE_LIMIT_EXCEEDED` | Per-user rate limit reached                     |
| `5xx`                     | Server error                                    |