---
id: apimatic-core
version: "0.2.25"
license: MIT
license_treatment: permissive
maintenance: active
---

# apimatic-core — A library that contains core logic and utilities for consuming REST APIs using Python SDKs generated by APIMatic.

License: permissive · Maintenance: active · Downloads: 176.3K/mo

## What it is and what it does

apimatic-core is a foundational library that powers REST API SDKs generated by APIMatic. It abstracts the mechanics of building HTTP requests, handling responses, managing authentication (headers, query parameters, or combinations thereof), validating data against schemas, and deserializing responses back into Python objects. The library is not meant to be used directly in most cases—it's the runtime engine that generated SDKs depend on—but developers who build or customize API clients may interact with its RequestBuilder, APICall, ResponseHandler, and authentication classes directly.

The package bundles configuration classes for both global and per-endpoint settings, exception types for validation failures, logging infrastructure, and HTTP utilities like proxy support. Its seven runtime dependencies (jsonpickle, python-dateutil, requests, setuptools, jsonpointer, typing-extensions, and apimatic-core-interfaces) are all stable, mature libraries. The library is actively maintained.

Use it for:

- Building custom REST API clients that need request construction, response parsing, and auth handling without writing boilerplate.
- Extending or customizing SDKs generated by APIMatic by leveraging its authentication, validation, and logging infrastructure.
- Implementing multi-factor authentication flows using the And/Or authentication group classes.
- Configuring HTTP proxies and client settings for API calls in enterprise or restricted network environments.
- Validating API responses against union-type schemas using oneOf and anyOf validation exceptions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides core runtime utilities for REST API SDKs, including HTTP request/response handling, authentication schemes, data validation, and object deserialization.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and carries low install friction. Install it if you are using an APIMatic-generated SDK or building a custom REST client that needs robust request/response and authentication handling. It is not a general-purpose HTTP library; it is a specialized runtime for API consumption patterns.

## Install

pip install apimatic-core
uv add apimatic-core
poetry add apimatic-core

## Installing apimatic-core

Before you install: Low install friction with a pure Python wheel distribution. Active maintenance with a recent release 67 days ago and commits through August 2026. Seven runtime dependencies are all standard, widely-used packages.

License in practice: MIT license is permissive; you can use this package in commercial and proprietary projects with minimal restrictions, provided you include the license notice.

Quickstart:

pip install apimatic-core

from apimatic_core.request_builder import RequestBuilder
from apimatic_core.api_call import APICall
from apimatic_core.response_handler import ResponseHandler

builder = RequestBuilder('GET', 'https://api.example.com/endpoint')
request = builder.build()

Verify before relying:

- Whether Python 3.7+ requirement is enforced at install time or only documented
- Real-world performance characteristics under high request volume
- Compatibility guarantees across minor version updates

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 176.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

REST API SDK runtime, HTTP request builder, API authentication handler, response deserialization, API call utilities, SDK core library, HTTP client configuration, rest-api, sdk-runtime, http-client

[View on SkillFed](https://skillfed.io/packages/apimatic-core) · [View on PyPI](https://pypi.org/project/apimatic-core/)