/**
 * @module Misc Types
 */
import { paths, components } from "@ideal-postcodes/openapi";
export declare type AddressResponse = paths["/addresses"]["get"]["responses"][200]["content"]["application/json"];
export declare type AddressSuggestionResponse = paths["/autocomplete/addresses"]["get"]["responses"][200]["content"]["application/json"];
export declare type UsaResolveResponse = paths["/autocomplete/addresses/{address}/usa"]["get"]["responses"][200]["content"]["application/json"];
export declare type GbrResolveResponse = paths["/autocomplete/addresses/{address}/gbr"]["get"]["responses"][200]["content"]["application/json"];
export declare type PublicKeyResponse = paths["/keys/{key}"]["get"]["responses"][200]["content"]["application/json"];
export declare type PrivateKeyResponse = paths["/keys/{key}/details"]["get"]["responses"][200]["content"]["application/json"];
export declare type KeyUsageResponse = paths["/keys/{key}/usage"]["get"]["responses"][200]["content"]["application/json"];
export declare type PostcodesResponse = paths["/postcodes/{postcode}"]["get"]["responses"][200]["content"]["application/json"];
export declare type UdprnResponse = paths["/udprn/{udprn}"]["get"]["responses"][200]["content"]["application/json"];
export declare type UmprnResponse = paths["/umprn/{umprn}"]["get"]["responses"][200]["content"]["application/json"];
export declare type KeyStatus = components["schemas"]["ApiKey"];
export declare type PafAddress = components["schemas"]["PafAddress"];
export declare type MrAddress = components["schemas"]["MrAddress"];
export declare type NybAddress = components["schemas"]["NybAddress"];
export declare type UkAddress = PafAddress | MrAddress | NybAddress;
/**
 * Authenticable
 *
 * If options require authentication
 */
export interface Authenticable {
    /**
     * Providing an api_key will overwrite the api_key embedded in the client
     */
    api_key?: string;
    /**
     * If the request is made by a licensee, this should be included here
     */
    licensee?: string;
}
/**
 * AdminAuthenticable
 *
 * If options require a user token
 */
export interface AdminAuthenticable {
    /**
     * For sensitive API operations, such as viewing key usage, a user_token is required
     */
    user_token: string;
}
/**
 * Address object attributes
 */
export declare type AddressKeys = keyof components["schemas"]["PafAddress"];
/**
 * Filterable
 *
 * Filter result for specific attribute, e.g. "line_1", "postcode", "organisation_name"
 */
export interface Filterable {
    /**
     * You can reduce the size of the response payload selecting for only the attributes you want to see
     *
     * @example
     *
     * ```javascript
     * {
     *   filter: ["line_1", "line_2", "line_3", "post_town", "postcode"],
     * }
     * ```
     */
    filter?: AddressKeys[];
}
/**
 * HttpOptions
 *
 * Basic HTTP options
 */
export interface HttpOptions {
    /**
     * For node.js client only, you can forward an IP address to be rate limited. Useful for backend integrations where the API would only see your application server IP addresses
     *
     * This header will not be applied on browser requests as IDPC-Source-IP is not listed as an allowed header
     */
    sourceIp?: string;
    /**
     * Overwrite the default HTTP request timeout defined in client
     */
    timeout?: number;
}
/**
 * Taggable
 *
 * Request can be tagged with up to 5 tags (no longer than 16 characters each)
 */
export interface Taggable {
    /**
     * Submit tags to annotate paid API requests for retrieve and aggregation later
     *
     * Restrictions:
     * - You may only specify up to 5 tags per API request
     * - Each tag must not be longer than 16 UTF-8 characters
     *
     * [Tagging & Metadata API Documentation](https://ideal-postcodes.co.uk/documentation/metadata)
     */
    tags?: string[];
}
/**
 * Paginateable
 *
 * Some requests can be paginated, e.g. address search and multiple residence
 * postcode lookup
 */
export interface Paginateable {
    /**
     * Page number. Zero based index
     */
    page?: number;
    /**
     * Maximum number of results per page
     */
    limit?: number;
}
/**
 * QueryValue
 */
export declare type QueryValue = undefined | number | string | (string | number)[];