# Documentation — QubitOn API

## Authentication

Two authentication methods are supported:

### API Key

Include your API key in the request header:

```bash
curl -X POST https://www.qubiton.com/api/address/validate \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address1": "123 Main St", "city": "New York", "state": "NY", "postalCode": "10001", "country": "US"}'
```

### OAuth2 (Client Credentials)

```bash
# 1. Get an access token
curl -X POST https://www.qubiton.com/api/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_SECRET"

# 2. Use the token
curl -X POST https://www.qubiton.com/api/address/validate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"address1": "123 Main St", "city": "New York", "state": "NY"}'
```

## SDKs

| Language | Install | Docs |
|----------|---------|------|
| Python | ``pip install qubiton`` | [PyPI](https://pypi.org/project/qubiton/) |
| Node.js | ``npm install @qubiton/sdk`` | [npm](https://www.npmjs.com/package/@qubiton/sdk) |
| Go | ``go get github.com/qubitonhq/qubiton-go`` | [pkg.go.dev](https://pkg.go.dev/github.com/qubitonhq/qubiton-go) |

## API Reference

- [OpenAPI Specification](https://www.qubiton.com/api/portal/openapi.json)
- [AI Plugin Manifest](https://www.qubiton.com/.well-known/ai-plugin.json)
- [MCP Manifest](https://mcp.qubiton.com/.well-known/mcp.json)

## Quick Examples

### Validate an Address

```bash
curl -X POST https://www.qubiton.com/api/address/validate \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address1": "123 Main St", "city": "New York", "state": "NY", "postalCode": "10001", "country": "US"}'
```

### Validate a Tax ID

```bash
curl -X POST https://www.qubiton.com/api/tax/validate \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"taxId": "12-3456789", "country": "US", "taxIdType": "EIN"}'
```

### Screen Against Sanctions

```bash
curl -X POST https://www.qubiton.com/api/prohibited/lookup \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Entity Name", "country": "US"}'
```

## Rate Limits

| Plan | Rate Limit |
|------|------------|
| Free | 10 req/min |
| Pay-as-You-Go | 60 req/min |
| Pro API | 300 req/min |
| Enterprise | Custom |

## Support

- Email: support@qubiton.com
- [Pricing & Plans](https://www.qubiton.com/pricing.md)
- [All Capabilities](https://www.qubiton.com/capabilities.md)