# Paisabazaar — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and compare credit cards from multiple banks, filtering by category or specific issuers to find cards matching your rewards preferences and eligibility. Get detailed information on fees, rewards programs, and requirements to make informed decisions about which card suits your financial needs.

**Category:** Finance & Markets | **Website:** [paisabazaar.com/](https://paisabazaar.com/) | **Docs:** [parse.bot/marketplace/882151e4-0214-4017-b9e5-aa9540148b97/paisabazaar-com-api](https://parse.bot/marketplace/882151e4-0214-4017-b9e5-aa9540148b97/paisabazaar-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get credit card details

Get full details of a specific credit card including fees and charges, features, eligibility criteria, and FAQs. The bank_slug and card_slug are extracted from card links returned by listing endpoints (e.g. link '/hdfc-bank/hdfc-regalia-gold-credit-card/' yields bank_slug='hdfc-bank' and card_slug='hdfc-regalia-gold-credit-card').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_slug` | string | Yes | Slug of the bank (first path segment in card links from listing endpoints). |
| `card_slug` | string | Yes | Slug of the card (last path segment in card links from listing endpoints). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/get-credit-card-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bank_slug":"<string>","card_slug":"<string>"}'
```

### List banks

List all supported bank slugs that can be used with list_credit_cards_by_bank and get_credit_card_details endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/list-banks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List categories

List all supported category slugs that can be used with list_credit_cards_by_category endpoint.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List credit cards

List the top 10 credit cards from the Paisabazaar top-10 page. Returns cards with fees, highlights, and category tags. Single-page response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/list-credit-cards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List credit cards by bank

List credit cards offered by a specific bank. Returns all cards listed on the bank's credit card page with fees, highlights, and categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_slug` | string | Yes | Slug of the bank as returned by list_banks endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/list-credit-cards-by-bank \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bank_slug":"<string>"}'
```

### List credit cards by category

List credit cards in a specific category. Returns all cards on the category page with fees, highlights, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Slug of the category as returned by list_categories endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/list-credit-cards-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### Search credit cards

Search for credit cards by keyword. Matches against card names, categories, highlights, and bank names from the main credit card listing and top-10 pages. Each search term is matched independently (OR logic). Returns cards from the main listing page that match any query term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. Multi-word queries match if any word appears in card name, categories, highlights, or bank name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/paisabazaar/search-credit-cards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.