📄 RFQs

Request for Quote (RFQ) Management

RFQs are the starting point for all translation and localization projects.

RFQ Lifecycle

DRAFT ──▶ PENDING ──▶ CHANGED_TO_QUOTE ──▶ CHANGED_TO_PROJECT
  │                          │
  │                          └──▶ Project begins!
  │
  └──▶ CANCELLED

Status Descriptions

Status

Description

Can Edit?

DRAFT

Being prepared

✅ Yes

PENDING

Submitted, awaiting quote

❌ No

CHANGED_TO_QUOTE

Quote provided

❌ No

CHANGED_TO_PROJECT

Accepted, project started

❌ No

CANCELLED

Cancelled

❌ No

📋 List RFQs

get

/api/public/v1/rfqs

List Your RFQs

Retrieve a paginated list of RFQs accessible to your API credentials.

Filtering Options

Parameter

Description

status

Filter by status (DRAFT, PENDING, etc.)

search

Search by project name or RFQ number

page

Page number (starts at 1)

limit

Items per page (max 100)

Response

Returns a summary view of each RFQ - use GET /api/public/v1/rfqs/:id for full details.

Authorizations

AuthorizationstringRequired

JWT access token obtained from POST /api/credentials/token

How to authenticate:

Generate API credentials from the Adaptria Portal
Exchange credentials for a token: POST /api/credentials/token
Include the token in all requests: Authorization: Bearer <token>

Token Expiration: 1 hour (3600 seconds)

Query parameters

pagestringOptional

Page number to retrieve (starts from 1)

Default: 1Example: 1Pattern: ^\d+$

limitstringOptional

Number of items per page (max 100)

Default: 20Example: 20Pattern: ^\d+$

statusstringOptional

Filter by RFQ status.

Available values: DRAFT, PENDING, CANCELLED, CHANGED_TO_QUOTE, CHANGED_TO_PROJECT

Example: DRAFT

searchstringOptional

Search by project name or RFQ number

Example: Q4 Marketing

Responses

200

RFQs retrieved successfully

application/json

401

Authentication required

get

/api/public/v1/rfqs

GET /api/public/v1/rfqs HTTP/1.1
Host: localhost:3001
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "rfqNumber": "RFQ-2025-001234",
      "projectName": "text",
      "status": "DRAFT",
      "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "companyName": "text",
      "createdAt": "2026-01-23T09:46:09.796Z",
      "updatedAt": "2026-01-23T09:46:09.796Z",
      "submittedAt": "2026-01-23T09:46:09.796Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

📝 Create and Submit RFQ

post

/api/public/v1/rfqs

Create and Submit a Request for Quote (RFQ) - Unified API

This unified endpoint creates an RFQ with services and automatically submits it in a single API call.

What You Can Do in ONE Request

✅ Create the RFQ with project details
✅ Add LINGUISTICS services (translation) with source/target languages
✅ Add NON_LINGUISTICS services (video adaptation) with target markets
✅ Attach pre-uploaded files to services
✅ Add notification recipients
✅ Automatically submit for quoting

Service Types

LINGUISTICS (for translation/localization):

{
  "serviceId": "34acfed6-ae10-46e3-8896-9afe78c2ecdc",
  "type": "LINGUISTICS",
  "sourceLanguageId": "f5e4d3c2-b1a0-4321-8765-fedcba987654",
  "targetLanguageIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890", "b2c3d4e5-f6a7-8901-bcde-f12345678901"],
  "assetFileIds": ["67eb9e88-7962-41a1-9695-f2051a968728"]
}

NON_LINGUISTICS (for video adaptation, creative services like 3D animation):

{
  "serviceId": "0cf41489-6424-492a-8cd7-4f7eef02858e",
  "type": "NON_LINGUISTICS",
  "targetMarketIds": ["03b91040-5931-4c24-9310-7a33861edde2", "0f64c0dc-3e00-4b4f-86cc-9259a2b575d6"],
  "assetFileIds": ["67eb9e88-7962-41a1-9695-f2051a968728"]
}

Note: assetFileIds contains file IDs obtained from the File Upload endpoint. Upload files first, then use the returned fileId values here.

Internal Transformation

Your simplified input is automatically transformed to the internal format:

Public API Field

Internal Field

serviceId

serviceUUID

targetMarketIds[]

targetMarkets[].targetMarketId

sourceLanguageId

combos[].sourceLanguage

targetLanguageIds[]

combos[].targetLanguages[].languageId

Recommended Workflow

1. GET /api/public/v1/client/companies      → Get company ID (see [Companies](#tag/%F0%9F%8F%A2%20Companies) section)
2. GET /api/public/v1/client/services       → Get available services (see [Services](#tag/%F0%9F%93%8B%20Services) section)
3. GET /api/public/v1/client/languages      → Get language IDs (see [Languages](#tag/%F0%9F%8C%8D%20Languages) section)
4. GET /api/public/v1/client/target-markets → Get target market IDs (see [Target Markets](#tag/%F0%9F%8E%AF%20Target%20Markets) section)
5. (Optional) POST /api/files/upload/presigned-url → Upload files and get file IDs (see [File Upload](#tag/%F0%9F%93%A4%20File%20Upload) section)
6. POST /api/public/v1/rfqs                 → Create & submit RFQ (this endpoint)
7. GET /api/public/v1/rfqs/:id              → Check status

Auto Submit Control

By default (autoSubmit: true), the RFQ is submitted immediately. Set autoSubmit: false to create in DRAFT status.

PO Number Uniqueness

The poNumber field must be unique per company. Duplicate PO numbers return 409 Conflict.

Authorizations

AuthorizationstringRequired

JWT access token obtained from POST /api/credentials/token

How to authenticate:

Generate API credentials from the Adaptria Portal
Exchange credentials for a token: POST /api/credentials/token
Include the token in all requests: Authorization: Bearer <token>

Token Expiration: 1 hour (3600 seconds)

Body

companyIdstring · uuidRequired

The company ID this RFQ belongs to.

Important: You must have access to this company through your API credentials.

📖 To get company IDs: See the Companies section → GET /api/public/v1/client/companies

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

projectNamestring · min: 1 · max: 255Required

A clear, descriptive name for your project.

Best Practices:

Be specific: "Q4 Marketing Campaign - German Website" vs "Translation Project"
Include key identifiers: campaign name, product, date

Example: Q4 2025 Marketing Campaign - Website Localization

projectDescriptionstring · min: 1 · max: 2000Required

Detailed description of what needs to be translated/localized.

Include: Content type, volume estimate, specific requirements, file formats

Example:

Translate our new product landing page from English to German, French, and Spanish. Content includes marketing copy (~2,000 words), product specifications, and customer testimonials.

backgroundInfostring · max: 1000Optional

Additional context about your company, brand, or project

Example: We're a B2B SaaS company expanding into European markets. We have a brand style guide and terminology glossary.

targetAudiencestring · max: 500Optional

Who will consume the translated content? Helps with tone and terminology choices.

Example: European B2B decision-makers, primarily CTOs and IT managers

poNumberstring · max: 100Optional

Your internal Purchase Order number (must be unique per company)

Example: PO-2025-Q4-MKT-001

referenceNumberstring · max: 100Optional

Your internal reference or ticket number

Example: CAMP-2025-Q4-EU

projectDueDatestring | nullOptional

When do you need the final deliverables? (YYYY-MM-DD, can be null)

Example: 2025-12-31Pattern: ^\d{4}-\d{2}-\d{2}$

deadlineForQuotestring · dateOptional

By when do you need the quote? (YYYY-MM-DD)

Example: 2025-12-15Pattern: ^\d{4}-\d{2}-\d{2}$

companyUserIdsstring · uuid[]Optional

User IDs from the company to receive notifications

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

autoSubmitbooleanOptional

If true (default), the RFQ is automatically submitted. If false, created as DRAFT.

Default: trueExample: true

Responses

201

RFQ created and submitted successfully

application/json

400

Validation error - check required fields and service configuration

401

Authentication required

403

Access denied to the specified company

409

Duplicate PO number - PO numbers must be unique per company

post

/api/public/v1/rfqs

POST /api/public/v1/rfqs HTTP/1.1
Host: localhost:3001
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 947

{
  "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "projectName": "Q4 2025 Full Campaign - Translation + Animation",
  "projectDescription": "Translate website content and create animated web banners for European markets.",
  "backgroundInfo": "We're a B2B SaaS company expanding into European markets.",
  "targetAudience": "European B2B decision-makers",
  "poNumber": "PO-2025-Q4-MKT-001",
  "referenceNumber": "CAMP-2025-Q4-EU",
  "projectDueDate": "2025-12-31",
  "deadlineForQuote": "2025-12-15",
  "services": [
    {
      "serviceId": "8398f952-99f3-468a-a44c-6620a48dd07c",
      "type": "LINGUISTICS",
      "sourceLanguageId": "3ebf026a-578b-46cb-b4a5-de4b54bab575",
      "targetLanguageIds": [
        "7da3f046-8d67-4cdc-beea-8e9afdaeaf30"
      ],
      "assetFileIds": [
        "91cc2de4-293b-4c37-b257-5d39cd1133da"
      ]
    },
    {
      "serviceId": "e71b7bf7-ed9c-4ff1-8dec-f136e31e1aa1",
      "type": "NON_LINGUISTICS",
      "targetMarketIds": [
        "0f64c0dc-3e00-4b4f-86cc-9259a2b575d6"
      ],
      "assetFileIds": [
        "dc68867c-beb5-46e3-b291-47978c94783b"
      ]
    }
  ],
  "autoSubmit": true
}

{
  "success": true,
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rfqNumber": "RFQ-2025-001234",
    "projectName": "text",
    "status": "DRAFT",
    "company": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Acme Corporation"
    },
    "servicesAdded": 2,
    "createdAt": "2026-01-23T09:46:09.796Z",
    "updatedAt": "2026-01-23T09:46:09.796Z"
  },
  "message": "text"
}

🔍 Get RFQ Details

get

/api/public/v1/rfqs/{id}

Get Full RFQ Details

Retrieve complete information about a specific RFQ, including:

General information (name, description, dates)
Selected services
Language configuration
Target markets

Authorizations

AuthorizationstringRequired

JWT access token obtained from POST /api/credentials/token

How to authenticate:

Generate API credentials from the Adaptria Portal
Exchange credentials for a token: POST /api/credentials/token
Include the token in all requests: Authorization: Bearer <token>

Token Expiration: 1 hour (3600 seconds)

Path parameters

idstring · uuidRequired

RFQ ID

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Responses

200

RFQ details retrieved

application/json

401

Authentication required

403

Access denied

404

RFQ not found

get

/api/public/v1/rfqs/{id}

GET /api/public/v1/rfqs/{id} HTTP/1.1
Host: localhost:3001
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rfqNumber": null,
    "projectName": "text",
    "status": "DRAFT",
    "company": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "text"
    },
    "generalInformation": {
      "projectName": "text",
      "projectDescription": "text",
      "backgroundInfo": "text",
      "targetAudience": "text",
      "poNumber": "text",
      "referenceNumber": "text"
    },
    "projectDueDate": null,
    "deadlineForQuote": "text",
    "services": [
      {
        "id": "34acfed6-ae10-46e3-8896-9afe78c2ecdc",
        "name": "Translation"
      }
    ],
    "languages": {
      "sourceLanguages": [
        {
          "id": "3ebf026a-578b-46cb-b4a5-de4b54bab575",
          "name": "Danish"
        }
      ],
      "targetLanguages": [
        {
          "id": "3ebf026a-578b-46cb-b4a5-de4b54bab575",
          "name": "Danish"
        }
      ]
    },
    "targetMarkets": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Germany",
        "countryCode": "DE"
      }
    ],
    "createdAt": "2026-01-23T09:46:09.796Z",
    "updatedAt": "2026-01-23T09:46:09.796Z",
    "submittedAt": "2026-01-23T09:46:09.796Z"
  }
}

Previous🎯 Target Markets NextModels

Last updated 1 hour ago

Good morning

hashtagRequest for Quote (RFQ) Management

hashtagRFQ Lifecycle

hashtagStatus Descriptions

hashtag📋 List RFQs

hashtagList Your RFQs

hashtagFiltering Options

hashtagResponse

hashtag📝 Create and Submit RFQ

hashtagCreate and Submit a Request for Quote (RFQ) - Unified API

hashtagWhat You Can Do in ONE Request

hashtagService Types

hashtagInternal Transformation

hashtagRecommended Workflow

hashtagAuto Submit Control

hashtagPO Number Uniqueness

hashtag🔍 Get RFQ Details

hashtagGet Full RFQ Details

Request for Quote (RFQ) Management

RFQ Lifecycle

Status Descriptions

📋 List RFQs

List Your RFQs

Filtering Options

Response

📝 Create and Submit RFQ

Create and Submit a Request for Quote (RFQ) - Unified API

What You Can Do in ONE Request

Service Types

Internal Transformation

Recommended Workflow

Auto Submit Control

PO Number Uniqueness

🔍 Get RFQ Details

Get Full RFQ Details