# Mvit — 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.

> Retrieve comprehensive information about MVIT Puducherry's faculty members, view detailed placement statistics, and access organized tabular data about the institute. Get quick insights into faculty profiles and recruitment outcomes to learn more about the college's academic and career placement landscape.

**Category:** Education | **Website:** [mvit.edu.in/](https://mvit.edu.in/) | **Docs:** [parse.bot/marketplace/1e14be0f-5c9e-4671-b2b6-06b582daec46/mvit-edu-in-api](https://parse.bot/marketplace/1e14be0f-5c9e-4671-b2b6-06b582daec46/mvit-edu-in-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/mvit/`
**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 faculty

Retrieve the complete faculty list for a specific department at MVIT. Returns each faculty member's name, qualification, designation, specialization, date of joining, and profile URL when available. Results are returned in a single page ordered by seniority.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `department` | string | Yes | Department code to fetch faculty for. |

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

### Get placement stats

Retrieve year-wise placement statistics for MVIT including number of recruiting companies, students attended, and students placed. Returns historical data across multiple academic years.

**Estimated cost:** Metered

_No parameters required._

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

### Get table data

Retrieve raw data from any Ninja Tables table on the MVIT website by its numeric table ID. Useful for accessing any structured data table such as placement details, research publications, or other institutional data. HTML markup in cell values is preserved as-is.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sorting` | string | No | Sort order for the table rows. |
| `table_id` | string | Yes | Numeric ID of the Ninja Tables table to fetch (e.g. '6469' for placement batch details, '2774' for EEE faculty). Found in the page source or network traffic. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mvit/get-table-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sorting":"<string>","table_id":"<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.