Field Mapping

curl --request POST \
  --url https://pdfmage.app/api/v1/field-mapping \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer pk_live_abc123...' \
  --form 'file=@/path/to/form.pdf'

const formData = new FormData();
formData.append('file', pdfFile);

const response = await fetch('https://pdfmage.app/api/v1/field-mapping', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pk_live_abc123...'
  },
  body: formData
});

if (response.ok) {
  const mappingResult = await response.json();
  console.log('Fields detected:', mappingResult.statistics.totalFields);
  console.log('Mapping success rate:', mappingResult.statistics.mappingSuccess);
  
  mappingResult.fields.forEach(field => {
    console.log(`Field: ${field.name} - Confidence: ${field.mapping.confidence}`);
  });
} else {
  const error = await response.json();
  console.error('Error:', error);
}

{
  "fileName": "employment-form.pdf",
  "processedAt": "2024-01-15T10:30:45.123Z",
  "pageCount": 1,
  "fields": [
    {
      "name": "firstName",
      "type": "text",
      "required": true,
      "page": 1,
      "position": {
        "x": 120.5,
        "y": 680.2
      },
      "mapping": {
        "relevantText": "First Name: John",
        "confidence": 0.95,
        "reasoning": "Field label 'firstName' matches document text 'First Name: John'"
      }
    },
    {
      "name": "employmentDate",
      "type": "text", 
      "required": false,
      "page": 1,
      "position": {
        "x": 120.5,
        "y": 640.8
      },
      "mapping": {
        "relevantText": "Start Date: January 15, 2024",
        "confidence": 0.87,
        "reasoning": "Employment date field likely corresponds to 'Start Date' in document"
      }
    }
  ],
  "statistics": {
    "totalFields": 12,
    "mappedFields": 10,
    "unmappedFields": 2,
    "mappingSuccess": 0.83
  },
  "extractedText": {
    "fullText": "Employment Application\n\nFirst Name: John\nLast Name: Doe\nStart Date: January 15, 2024...",
    "pageCount": 1
  }
}

HTTP/1.1 200 OK
Content-Type: application/json
X-Credits-Used: 0.01
X-Credits-Remaining: 4.99
X-Credits-Currency: USD

{
  "error": "Unprocessable Entity",
  "message": "No form fields found in PDF",
  "details": {
    "code": "NO_FORM_FIELDS",
    "pageCount": 2,
    "suggestion": "Ensure PDF contains fillable form fields"
  },
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_abc123"
}

{
  "error": "Bad Request", 
  "message": "Invalid file format",
  "details": {
    "code": "INVALID_FILE_FORMAT",
    "allowedFormats": ["pdf"],
    "receivedFormat": "docx"
  },
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_def456"
}