SVG to PNG API
Convert svg files to png with a single POST request. Upload a file as multipart/form-data and the API returns a download URL for the converted file.
Input
svg
Output
png (image/png)
Credit cost
1 per file
Max file size
Per plan (10–500 MB)
Endpoint
https://api.fileswitch.co/api/v1/converter/svg-to-pngAuthentication is optional for guests and recommended for production. Send either an API key or a JWT access token as a Bearer token. Authenticated requests deduct 1 credit from your balance; failed conversions are refunded. See Authentication for details.
Quick start
The same request in every supported language. Each example uploads a file and prints the downloadUrl from the response.
curl -X POST https://api.fileswitch.co/api/v1/converter/svg-to-png \
-H "Authorization: Bearer fc_YOUR_API_KEY" \
-F "file=@input.svg" \
-F "width=0" \
-F "height=0" \
-F "fit=inside" \
-F "background=transparent" \
-F "density=150"Parameters
Send file plus any optional options. Every option is optional and falls back to its default when omitted.
| Field | Type | Default | Description |
|---|---|---|---|
| file | binary | — | The file to convert. Accepts .svg |
| width | number | 0 | Output width in pixels; 0 keeps the original width. Range: 0 .. 10000 |
| height | number | 0 | Output height in pixels; 0 keeps the original height. Range: 0 .. 10000 |
| fit | string | inside | How the resized image fits the requested box. Values: cover, contain, fill, inside, outside |
| background | string | transparent | Background color (hex or "transparent"). |
| density | number | 150 | Rasterization density in DPI. Range: 72 .. 1200 |
{
"file": "input.svg",
"width": 0,
"height": 0,
"fit": "inside",
"background": "transparent",
"density": 150
}Response
Every conversion endpoint returns the same success / message / data envelope. The data object is a Conversion record with a temporary downloadUrl.
{
"success": true,
"message": "Conversion completed",
"data": {
"id": "b10a5f2e-8c1e-4b3a-9c1d-2e3f4a5b6c7d",
"inputFormat": "html",
"outputFormat": "pdf",
"inputFileName": "document.html",
"outputFileName": "document.pdf",
"inputFileSize": 45210,
"outputFileSize": 88431,
"status": "completed",
"error": null,
"creditCost": 2,
"downloadUrl": "/api/v1/converter/download/conversions%2Fb10a5f2e-8c1e-4b3a-9c1d-2e3f4a5b6c7d%2Foutput.pdf",
"createdAt": "2026-07-31T13:00:00.000Z",
"completedAt": "2026-07-31T13:00:02.000Z"
}
}Prepend https://api.fileswitch.co/api/v1 to the downloadUrl and download with the same credentials. Files are retained temporarily and auto-deleted. See the full field reference in Response Schema.
Related conversions
Ready to convert svg → png? Start free — no credit card required.