# Find a credit

> Search a borrower. Same idea as Find credit in the terminal.

### Overview

`q=` an exact name, or one hit, returns the credit card: `issuer` plus `marks`. Many hits return `issuers[]`. A miss may still sit unmatched on a fund tape.

```
GET https://dirigon.com/v1/issuers?q=Coupa
GET https://dirigon.com/v1/issuers?sort=holders&limit=25
```

### Query

| Param | Where | Meaning |
| ----- | ----- | ------- |
| q | query | Name search. Exact or one hit opens the card. |
| issuer_id | path | Credit id (`ISS-######`). |
| limit | query | How many rows to return. Default 100, max 500. |
| cursor | query | From `next_page_url` on a list. |

### Example

```python
import requests
headers = {"X-API-KEY": "YOUR_KEY"}
body = requests.get("https://dirigon.com/v1/issuers?q=Coupa", headers=headers).json()
iss = body.get("issuer") or (body.get("issuers") or [{}])[0]
print(iss.get("issuer_id"), iss.get("display_name"), iss.get("n_holders"))
print("marks", len(body.get("marks") or []))
```

```bash
curl "https://dirigon.com/v1/issuers?q=Coupa" -H "X-API-KEY: YOUR_KEY"
```

### Response (card)

```json
{
  "issuer": {
    "issuer_id": "ISS-015563",
    "display_name": "Coupa"
  },
  "marks": []
}
```

### Fields

| Field | Meaning |
| ----- | ------- |
| issuer_id | Credit id. Use this in later calls. |
| display_name | Credit name. |
| n_holders | How many funds print it. |
| total_fv_m | Fair value across those holders, $ millions. |
| blocked | True if the name is disputed. Skip it for comparisons. |
| marks | Holder marks on the card. Same grain as [Holder marks](https://dirigon.com/docs/holder-marks.md). |

Next: [Holder marks](https://dirigon.com/docs/holder-marks.md).