# Useme API docs ## Docs - Guides [API 1.0 Deprecation](https://apidocs.useme.com/v1.0/doc-2270659.md): - Guides [Introduction](https://apidocs.useme.com/v1.0/doc-508209.md): - Guides [Getting Started](https://apidocs.useme.com/v1.0/doc-508218.md): - Guides [Creating Contractors](https://apidocs.useme.com/v1.0/doc-508213.md): - Guides [Creating Deals](https://apidocs.useme.com/v1.0/doc-508215.md): - Guides [Retrieving Deal Details](https://apidocs.useme.com/v1.0/doc-2129845.md): ## API Docs - Reference > Categories [List categories](https://apidocs.useme.com/v1.0/api-34860105.md): Retrieves a list of either main categories or subcategories. If an 'id' query parameter is not provided, it returns all main categories. If an 'id' query parameter is provided, it returns all subcategories related to the main category of the given 'id'. - Reference > Contractors [Create a new contractor](https://apidocs.useme.com/v1.0/api-34860106.md): Registers a new contractor with the given details. If the contractor already exists, it returns a conflict error. - Reference > Deals [Create a new deal](https://apidocs.useme.com/v1.0/api-34860107.md): Creates a new deal with the provided details. This operation involves registering the deal and creating related deal stage. - Reference > Deals [Retrieve deal details](https://apidocs.useme.com/v1.0/api-34860108.md): Returns full details of a single deal owned by the authenticated employer, including stage identifier, payment token, current status, currency, and billing breakdown for both sides. - Reference > Deals [Upload a file for a deal](https://apidocs.useme.com/v1.0/api-34860109.md): Allows authenticated users to upload files related to a deal stage. This endpoint expects a multipart form submission with a file and associated metadata. ## Schemas - Schemas [ContractorRequest](https://apidocs.useme.com/v1.0/schema-1964742.md): - Schemas [DealDetailsResponse](https://apidocs.useme.com/v1.0/schema-1964745.md): - Schemas [DealRequest](https://apidocs.useme.com/v1.0/schema-1964746.md): - Schemas [GetDealStageData](https://apidocs.useme.com/v1.0/schema-1964751.md): - Schemas [MainCategory](https://apidocs.useme.com/v1.0/schema-2019826.md): - Schemas [WorkFileRequest](https://apidocs.useme.com/v1.0/schema-1964755.md): - [APIDealBilling](https://apidocs.useme.com/v1.0/schema-14725828.md): - [BadRequestResponse](https://apidocs.useme.com/v1.0/schema-1964739.md): - [ConflictResponse](https://apidocs.useme.com/v1.0/schema-1964740.md): - [APIDealContractorPayment](https://apidocs.useme.com/v1.0/schema-14725829.md): - [Contractor](https://apidocs.useme.com/v1.0/schema-2019593.md): - [APIDealEmployerPayment](https://apidocs.useme.com/v1.0/schema-14725830.md): - [ContractorData](https://apidocs.useme.com/v1.0/schema-1964741.md): - [APIRetrieveDealResponse](https://apidocs.useme.com/v1.0/schema-14725831.md): - [CountryCodeEnum](https://apidocs.useme.com/v1.0/schema-1964743.md): - [DealCreateSuccessResponse](https://apidocs.useme.com/v1.0/schema-1964744.md): - [Deal](https://apidocs.useme.com/v1.0/schema-2019594.md): - [DealStageData](https://apidocs.useme.com/v1.0/schema-1964747.md): - [ErrorResponse](https://apidocs.useme.com/v1.0/schema-1964748.md): - [FileUploadData](https://apidocs.useme.com/v1.0/schema-1964749.md): - [FileUploadResponse](https://apidocs.useme.com/v1.0/schema-1964750.md): - [SubCategory](https://apidocs.useme.com/v1.0/schema-1964752.md): - [SuccessResponse](https://apidocs.useme.com/v1.0/schema-1964753.md): - [ValidationErrorResponse](https://apidocs.useme.com/v1.0/schema-1964754.md): - [RetrieveDealNotFoundResponse](https://apidocs.useme.com/v1.0/schema-14725832.md): - [RetrieveDealServerErrorResponse](https://apidocs.useme.com/v1.0/schema-14725833.md): - [RetrieveDealSuccessResponse](https://apidocs.useme.com/v1.0/schema-14725834.md): - [StatusEnum](https://apidocs.useme.com/v1.0/schema-14725835.md): - [WorkFile](https://apidocs.useme.com/v1.0/schema-14725836.md):